Изменение параметров времени трассы.

Edit time sampling trace parameters.

EDITT PEP-клиент.

Программа предназначена для изменения шага дискретизации, а также для изменения начального и конечного времени записи. Шаг дискретизации может быть увеличен или уменьшен в восемь, четыре или два раза. Программа применима как для временных, так и для глубинных разрезов. В последнем случае вместо милисекунд следует использовать метры.

Для измененения шага дискретизации рассчитывается комплексный спектр трассы. Затем, в случае уменьшения шага дискретизации в N раз (N = 8, 4 ,2) длина спектра увеличивается в N раз, дополняясь справа нулями. В случае увеличения шага дискретизации в N раз (N = 8, 4, 2) длина спектра уменьшается в N раз, то еcть до частоты равной половине частоты Найквиста исходной трассы. При этом часть спектра между четвертью и половиной частоты Найквиста умножается на COS. Далее - обратное преобразование Фурье для перехода во временную область. В выходную модификацию записывается вся трасса или ее фрагмент, в соответствии с указанными входными данными.

Результирующий временной интервал (для глубинного разреза - глубинный) может быть произвольным. При этом недостающие отсчеты дополняются нулями, а лишние - отбрасываются. При преобразовании шага и интервала сигнал на трассе не сдвигается.

Взаимодействие с другими программами.

Программа является PEP-клиентом, то есть, она запускается из-под оболочки пакетного запуска pktexec, предоставляющей сервис по заданию параметров, управлению выполнением и просмотру протокола работы программы.

Если необходимо сдвинуть трассы во времени, следует воспользоваться программой SHIFTR.

Описание.

Сеанс работы.

Задание параметров и запуск программы происходит из-под оболочки пакетного запуска pktexec. Типовой сеанс работы состоит из следующих шагов:

Запуск программы из меню пакета ВСП.
Задание проекта, в каталоге данных которого находится исходная модификация (пункт меню File -> Project...).
Задание имени входной модификации (поле Input modification).
Задание параметров работы программы:
- Параметра изменения шага дискретизации (поле Sampling rate change);
- Начального и конечного времени в выходной модификации (поле Time range output modification).
Задание имени выходной модификации (поле Output modification).
Запуск программы на выполнение (кнопка Start в панели инструментов или пункт меню EDITT -> Start).
На "бегунке" (Count of processed input traces) отображается относительное количество обработанных трасс.
В процессе выполнения программы отображается также кабельная глубина обрабатываемой в данной момент трассы (поле Trace cable depth ).
Для просмотра протокола прохождения программы надо нажать кнопку View log в панели инструментов или выбрать пункт меню EDITT -> View log.
Для выхода из среды пакетного запуска нужно нажать кнопку Exit в панели инструментов или выбрать пункт меню File -> Exit.

Параметры обработки.

Входные параметры (панель Parameters).

Input modification: Имя: inmod
Тип: nmod_s
Описание: Входная модификации
Sampling rate change: Имя: param
Тип: enum(x 8|x 4|x 2|the same|/ 2|/ 4|/ 8)
Описание: Параметр задающий как и во сколько раз будет изменятся шаг дискретизации. Шаг дискретизации может быть увеличен или уменьшен в 8, 4, 2 раза или остаться прежним(режим the same)
Time range output modification (ms): Имя: trange
Тип: float2
Описание: Интервал трассы по времени, записываемый в выходную модификацию. Необходимо следить за тем, чтобы начальное время этого интервала было не меньше начального времени исходной трассы, а конечное время не больше конечного времени исходной трассы
Output modification: Имя: outmod
Тип: nmod_e
Описание: Выходная модификация

Информация о процессе работы программы(панель Runtime).

Count of processed input traces: Имя: runner
Тип: progress
Описание: Визуально показывает долю обработанных входных трасс
Trace cable depth: Имя: hcab
Тип: float
Описание: Текущая кабельная глубина

Параметры результатов (панель Results).

Output modification: Имя: outmod
Тип: nmod_e
Описание: Выходная модификация
Sampling rate in output modification (ms): Имя: dtout
Тип: float
Описание: Шаг дискретизации в выходной модификации
Time range output modification (ms): Имя: trangeout
Тип: float2
Описание: Результирующий временной интервал в выходной модификации.

Пользовательский интерфейс.

Для детального ознакомления с пользовательским интерфейсом оболочки пакетного запуска, смотри описание программы pktexec. Ниже приводится пример окна оболочки с активной панелью ввода параметров:

Входные данные.

Трассы.

На вход подается модификация с трассами, для которых пользователь желает изменить шаг дискретизации и(или) начальное, конечное время записи. Необходимо, чтобы шаг дискретизации исходных трасс был таков, что после его изменения в соответствии с заданными параметрами, он находился в интервале 0.017 .. 17 мс. Обрабатываются все трассы, содержащиеся во входной модификации.

Программа может использоваться для работы как с глубинными, так и с временными разрезами.

Выходные данные.

Трассы.

На выходе формируется модификация с трассами, в которых изменен шаг дискретизации, начальное, конечное время записи в соответствии с заданными параметрами.

Требования к окружению.

Операционное окружение.

Программа получает имя рабочего проекта через переменную среды PROJECT. В случае запуска программы из-под оболочки, это условие выполняется путем выбора рабочего проекта.

Программа определяет местонахождение системных файлов пакета из переменной VSPHOME, определенной в профиле пользователя или в файле setup в домашнем каталоге пользователя пакета. Файле setup данная переменная может выступать также под именем VSP.

Используемые файлы.

Программа ищет описание параметров в файлах $VSPHOME/etc/EDITT.pep и $VSPHOME/etc/vsp.pep.

В домашнем каталоге пользователя должен присутствовать файл setup, содержащий пути к каталогам данных, заданий и протоколов прохождения проектов, а также пути к системным файлам пакета ВСП.

Прочие требования.

Прочие требования накладываются оболочкой пакетного запуска pktexec.

Сообщения пользователю.

Способ доведения сообщений до пользователя.

Все сообщения выводятся в стандартный поток ошибок. В случае запуска программы из-под интерактивной оболочки сообщения сохраняются в файле протокола прохождения задания LOG/$PROJECT/EDITT-#.log. Сообщения классов серьезности EL_FATAL и EL_ERROR помещаются по завершении работы программы в область сообщений интерактивной оболочки.

Описание диагностических сообщений.

Диагностические сообщения, выводимые в информационную строку:

WARNING: Negative time - use source range Tb .. Te ms: Пользователь указал одно из времен результирующего временного диапазона отрицательным. Сообщение свидетельствует, что программа избрала в качестве результирующего диапазона исходный.
ERROR: Resulting sampling rate is out of range 0.017 .. 17 ms: При попытке уменьшить или увеличить шаг дискретизации результирующее значение вышло за допустимый диапазон.
ERROR: Error in time range.: Сообщение об ошибке в задании начального или конечного времени трассы в выходной модификации. Начальное время должно быть меньше конечного.
ERROR: Can't increase sampling rate due to Tb=N: Необходимо, чтобы начальное время во входной модификации было кратным шагу дискретизации.
ERROR: Can not open '%s' modification due to ERROR__some_error.: Ошибка открытия входной модификации.
ERROR: Can not create '%s' modification due to ERROR__some_error.: Ошибка создания выходной модификации.
"Can't allocate memory working buffer.": Сообщение о нехватке памяти для размещения рабочих массивов. Вероятнее всего имеет место внутренняя ошибка программы или ошибка входных данных.