Расчет амплитудного спектра.

Решаемые задачи и метод.

Программа предназначена для расчета амплитудных спектров сейсмических трасс и записи этих спектров в модификацию.

Спектр может быть расчитан по всей трассе, в окне от годографа первых вступлений или в окне по времени, одинаковом для всех трасс.

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

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

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

Описание.

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

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

Запуск программы из меню пакета ВСП.
Задание проекта, в каталоге данных которого находится исходная модификация (пункт меню File -> Project...).
Задание имени входной модификации (поле Input data modification).
Задание годографа первых вступлений, если расчет спектра будет производиться в режиме Hodograph window (поле Input table with hodograph (for regime 'Hodograph window'))
Задание параметров работы программы:
- диапазона кабельных глубин, трассы из которого выбираются для расчета спектра (поле Cable depth range (m));
- режима расчета спектра трассы (вся трасса, постоянное окно для всех трасс, окно от годографа) (поле Regime calculating spectr);
- временного интервала для расчета спектра(для режимов Hodograph window и Constant window) (поле Times window calculating (ms)).
Задание имени выходной модификации для записи спектров трасс (поле Output modification (spectr)).
Запуск программы на выполнение (кнопка Start в панели инструментов или пункт меню SPEKTR -> Start).
На "бегунке" (Count of processed input traces) отображается относительное количество обработанных трасс.
В процессе выполнения программы отображается также кабельная глубина обрабатываемой в данной момент трассы (поле Trace cable depth ).
Для просмотра протокола прохождения программы надо нажать кнопку View log в панели инструментов или выбрать пункт меню SPEKTR -> View log.
Для выхода из среды пакетного запуска нужно нажать кнопку Exit в панели инструментов или выбрать пункт меню File -> Exit.

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

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

Input data modification: Имя: inmod
Тип: nmod_s
Описание: Входная модификации для расчета спектра
Input table with hodograph (for regime 'Hodograph window'): Имя: dbfb
Тип: dbname_s(FBLIST)
Описание: Таблица с годографом первых вступлений для задания границы окна расчета спектра (необходим только в режиме Hodograph window)
Cable depth range (m): Имя: hrange
Тип: float2
Описание: Диапазон кабельных глубин, трассы из которого выбираются для расчета спектра
Regime calculating spectr: Имя: md
Тип: enum(Full trace|Constant window|Hodograph window)
Описание: Режим расчета спектра трассы (вся трасса, постоянное окно для всех трасс, окно от годографа)
Times window calculating (ms): Имя: trange
Тип: float2
Описание: Временной интервал расчета спектра Параметер предназначен для задания окна расчета спектра в режимах "постоянного окна" и "окна от годографа". В режиме "вся трасса" этот параметер можно не задавать. В режиме "постоянного окна" параметер означает интервал трассы (начальное и конечное время), по которому будет расчитан спектр. В режиме "окна от годографа" параметер означает отступ от времени первого вступления для задания границ окна расчета спектра(левый и правый отступ). Для сдвига границы влево параметер необходимо задать меньше нуля, вправо - больше нуля. Параметер задается в миллисекундах.
Output modification(spektr): Имя: outmod
Тип: nmod_e
Описание: Выходная модификация

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

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

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

Resulting modification (spektr): Имя: outmod
Тип: nmod_e
Описание: Выходная модификация со спектрами трасс

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

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

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

Трассы.

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

Таблицы БД.

На вход подается таблица БД с годографом первых вступлений.

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

Трассы.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

"Can not open '%s' modification. Error #%d": Сообщение об ошибке открытия входной модификации. Вероятно модификации с таким именем не существует на диске или пользователь не имеет к ней доступа.
"Can not create '%s' modification. Error #%d": Сообщение об ошибке открытия выходной модификации. Возможно модификация уже существует и в данный момент используется в режиме записи другой программой или другим пользователем.
"Can not open table with hodograph: %s": Сообщение об ошибке открытия таблицы БД с годографом первых вступлений. Вероятно таблицы с таким именем не существует на диске или пользователь не имеет к ней доступа.
"Error in parameters 'Times window calculating'": Сообщение об ошибке в задании окна расчета спектра: время меньше нуля или конечное время меньше начального.
"Can not find godograph time for trace with NMGL=%d, HCAB=%g, NTR=%d.": Сообщение о невозможности найти в таблице БД время первого вступления для трассы из входной модификации.
"Can't allocate memory working buffer.": Сообщение о нехватке памяти для размещения рабочих массивов.
"Bad time interval for trace with HCAB=%g, NMGL=%d, NTR=%d.": Сообщение об ошибке в задании окна расчета спектра: интервал расчета меньше двух дискретов.
"Error occured during computation of spectr at HCAB=%g, NMGL=%d, NTR=%d.": Сообщение об ошибке в задании окна расчета спектра: плохое окно расчета спектра.