Программа расчета азимутограммы.

Программа предназначена для расчета азимутограммы для трассы с указанной пользователем кабельной глубиной. Азимутограмма представляет собой набор трасс одной глубины регистрации, полученными при различной ориентации горизонтальной компоненты колебаний (осуществляется перебор по азимуту). Азимутограмма далее может быть использована для определения эффектов расщепления поперечных волн, связанных с возможной трещиноватостью пород.

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

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

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

Описание.

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

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

Запуск программы из меню пакета ВСП.
Задание проекта (пункт меню File -> Project...).
Задание входных параметров:
- входной модификации трехкомпонентных сейсмических трасс в географической системе координат;
- кабельной глубины входной трассы для расчета азимутограммы;
- шага перебора по азимуту;
- выходной модификации для записи азимутограммы;
Запуск программы на выполнение (кнопка Start в панели инструментов или пункт меню Azgram -> Start).
Во время выполнения программы выдается текстовая информационная строка, сообщающая, какой этап работ выполняется, а также бегунок, показывающий относительное число уже обработанных трасс.
Для просмотра протокола прохождения программы надо нажать кнопку View log в панели инструментов или выбрать пункт меню Azgram -> View log.
Для выхода из среды пакетного запуска нужно нажать кнопку Exit в панели инструментов или выбрать пункт меню File -> Exit.

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

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

"Input modification in geographic coordinate system": Имя: iwave
Тип: nmod_s
Описание: Входная модификация трехкомпонентных сейсмических трасс в географической системе координат.
"Cable depth for processing (m)": Имя: hcab
Тип: float
Описание: Кабельная глубина трассы для расчета азимутограммы..
"Azimuth step (degree)": Имя: step
Тип: floar
Описание: Шаг перебора по азимуту для расчета азимутограммы.
"Output modification (azimuthogram)": Имя: owave
Тип: nmod_e
Описание: Имя выходной модификации для записи азимутограммы.

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

"Executing": Имя: p_progress
Тип: string
Описание: Информационная строка, отображающая этап работы программы.
"Done traces:": Имя: done
Тип: progress
Описание: Показывает относительное количество обработанных трасс.

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

"Output modification (azimuthogram)": Имя: rwave
Тип: nmod_s
Описание: Выходная модификация с трассами, полученными при различной ориентации горизонтальной компоненты колебаний(азимутограмма).

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

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

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

Трассы.

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

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

Трассы.

Выходом программы является модификация с трассами, полученными при различной ориентации горизонтальной компоненты колебаний (азимутограмма). В поле HCAB (кабельная глубина) трассы записано соответствующее ей значение азимута горизонтальной компоненты колебаний.

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

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

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

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

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

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

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

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

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

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

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

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

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

Список кодов и идентификаторов ошибок (обозначаемых ниже ERROR_IDENT), начинающихся с "ERROR__" приводится в документе Коды ошибок программ пакета UNIVERS.

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

"Azimuth step must be more than 0 and less than 360!": Значение шага по азимуту должно быть больше 0 и меньше 360.
"Couldn't open input modification 'Sxxx' due to ERROR_IDENT": Не удалось открыть модификацию входных трасс.
"Can not create output modification 'Sxxx' due to ERROR_IDENT": Не удалось создать выходную модификацию.
"Can't select input traces due to ERROR_IDENT": Во входной модификации нет актуальных трасс глубинного типа.
"Traces X or Y component for HCAB= ____ is not found!": На указанной глубине не найдена X или Y компонента трассы. Либо трассы указанной модификации однокомпонентные, либо трасс с указанной кабельной глубиной нет во входной модификации.