Ориентация сейсмических трасс.

Orientation of seismic traces.

SPIN PEP-клиент

Программа предназначена для ориентации сейсмических трасс в выбранную систему координат. Предусмотрена ориентация трасс в одну из трех систем координат: поляризационную систему PRT, географическую систему, ПВ-направленную географическую систему. Возможна также ориентация в систему координат сейсмоприемника. Исходная система координат, из которой производится ориентация, может быть любой из вышеназванных. Для работы программы необходима также таблица базы данных с информацией о параметрах поляризации.

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

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

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

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

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

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

Описание.

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

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

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

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

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

"Input modification": Имя: iwave
Тип: nmod_s
Описание: Входная модификация.
"Input polarization parameters table": Имя: dbpm
Тип: dbname_s(PMLIST)
Описание: Таблица БД типа PMINFO с параметрами поляризации прямой волны.
"Input system:": Имя: InpSyst
Тип: enum
Описание: Исходная система координат. Задает систему координат трасс во входной модификации. Необходимо выбрать одну из четырех систем координат: система сейсмоприемника, поляризационная ситема PRT, географическая система, ПВ-направленная географическая система.
"Output system:": Имя: OutSyst
Тип: enum
Описание: Результирующая система координат. Задает систему в которую необходимо сориентироовать трассы. Необходимо выбрать одну из пяти систем координат: система сейсмопиеника, поляризационная ситема PRT, географическая система, ПВ-направленная географическая система, географическая система с заданной ориентацией оси X.
"X-axis's azimuth with North direction": Имя: azimuth
Тип: float
Описание: Задает угол оси X с напралением на север. Угол отсчитывается от направления на север по часовой стрелке. Этот параметер необходимо задавать только при ориентации в географическую систему с заданной ориентацией оси X.
"Output modification": Имя: owave
Тип: nmod_e
Описание: Выходная модификация ориентированных сейсмических трасс.

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

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

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

"Output modification": Имя: rwave
Тип: nmod_s
Описание: Модификация с ориентированными трехкомпонентными трассами.

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

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

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

Трассы.

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

Таблицы БД.

На вход программе подается таблица БД типа PMINFO с параметрами поляризации. Таблица необходима для всех преобразований, кроме ориентации из одной географической системы (географическая система, ПВ-направленная географическая система, географическая система с заданной ориентацией оси X) в другую географическую систему.

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

Трассы.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

"Input and output systems must be different!": Входная и выходная системы координат должны различаться.
"Couldn't open 'Sxxx' modification of input traces due to ERROR_IDENT": Не удалось открыть модификацию входных трасс.
"Could not open polarization parameters DB table 'VSP.xxxx.xx.FBINFO.xx' due to ERROR_IDENT.": Не удалось открыть таблицу БД с параметрами поляризации.
"Can not create 'Sxxx' modification for oriented traces due to ERROR_IDENT.": Не удалось создать выходную модификацию.
"Can't select input traces due to ERROR_IDENT.": Во входной модификации нет актуальных трасс глубинного типа.
"Could not find a DB entry for ZOP=____ and NMGL=____ in polarization table": Для обозначенных глубины и номера сейсмограммы Не найдена запись с параметрами поляризации.
"Could not orient wave at HCAB=____ NMGL=____; see below:": Для обозначенных глубины и номера сейсмограммы не удалось произвести ориентацию.
"Shot point coinsides observation point": Пункт взрыва совпадает с пунктом приема.
"Polarization parameters FI=0": Параметер поляризации FI=0.
"Internal error": Внутренняя ошибка. Обратитесь к разработчику.
"There were __ warnings. Please check log file.": В процессе выполнения программы были некритические ошибки. Смотрите LOG файл.
"There were errors and no traces were spinned!": В процессе выполнения программы были ошибки и не одна трасса не была ориентирована.