Программа расчета фиксированных компонент.

Calculation of fixed components.

FixComp PEP-клиент

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

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

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

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

Описание.

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

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

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

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

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

"Input modification": Имя: iwave
Тип: nmod_s
Описание: Входная модификация с трехкомпонентной записью в географической системе координат.
"Cable depth range for processing (m)": Имя: hrange
Тип: float2
Описание: Задает диапазон кабельных глубин входных трасс, для которых будут рассчитываться фиксированные компоненты.
"Dip values (degree)": Имя: angle
Тип: floar_ar1
Описание: Задает набор значений углов с вертикалью фиксированных компонент. Допускается задание нескольких значений углов. В этом случае параметры указываются через запятую или пробел. Параметр задается в градусах.
"Azimuth values (degree)": Имя: azimuth
Тип: floar_ar1
Описание: Задает набор значений азимутов фиксированных компонент. Допускается задание нескольких значений азимутов. В этом случае параметры указываются через запятую или пробел. Параметр задается в градусах..
"Output modification (fixed components)": Имя: owave
Тип: nmod_e
Описание: Выходная модификация для записи фиксированных компонент.

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

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

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

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

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

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

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

Трассы.

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

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

Трассы.

Выходом программы является модификация фиксированных компонент. Все рассчитанные фиксированные компоненты записываются в одну модификацию. Различными являются номера трасс(каналов) NTR у разных компонент трассы. Для просмотра отдельных компонент созданной модификации необходимо в программе Trace Visualization воспользоваться функцией выбора трасс по номерам каналов - NTR. Таблица соответствия между номерами трасс и углами, задающими фиксированную компоненту, приводиться протоколе работы программы (пункт меню "View log").

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

"Not input or input error azimuth values!": Не заданы или заданы с ошибкой значения азимутов.
"Not input or input error dip values!": Не заданы или заданы с ошибкой значения углов.
"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": Во входной модификации нет актуальных трасс глубинного типа.
"There were errors and no traces was written!": В процессе выполнения программы были ошибки и не одна трасса не записана в выходную модификацию.