Определение параметров поляризации.

Polarization parameters determination.

POL PEP-клиент

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

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

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

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

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

Описание.

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

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

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

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

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

Input modification: Имя: wave
Тип: nmod_s
Описание: Входная модификация с трехкомпонентной записью
Input first break hodograph table: Имя: dbfb
Тип: dbname_s(FBLIST)
Описание: Входная таблица БД с годографом первых вступлений
Cable depth range for processing (m): Имя: frange
Тип: float2
Описание: Диапазон кабельных глубин для обработки
Window's shift from first break(ms): Имя: tShift
Тип: float
Описание: Отступ от времени первого вступления (начало интервала трассы, в котором будет производиться расчет параметров поляризации)
Dip determination window's length (ms): Имя: tLenSm; Тип: float
Описание: Длина окна оценки зенитного угла (угла с вертикалью) подхода волны
Azimuth determination window's length (ms): Имя: tLenBig
Тип: float
Описание: Длина окна оценки азимута подхода волны
Output polarization parameters table: Имя: dbpm
Тип: dbitem_e(VSP.PMLIST)
Описание: Выходная таблица БД с параметрами поляризации

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

Executing: Имя: p_progress
Тип: string
Описание: Отображает этап расчетов ("Checking parameters", "Sorting traces", "Calculating polarization parameters")
Done traces:: Имя: done
Тип: progress
Описание: Отображает относительное количество обработанных трасс

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

Output polarization parameters table: Имя: dbpm_out
Тип: dbname_s(PMLIST)
Описание: Таблица с параметрами поляризации.

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

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

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

Трассы.

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

Таблицы БД.

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

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

Трассы.

N/A

Таблицы БД.

Программа формирует таблицы БД типа PMINFO и их список типа PMLIST (в том случае если он отсутствует).

Таблица БД PMLIST.

При формировании строки в таблице-списке PMLIST поля получат следующие значения:

NVAR - уникальный номер варианта таблицы параметров;
SOURCE - указатель на таблицу типа FBINFO с временами первых вступлений, используемую при оценке параметров поляризации;
NMOD - номер модификации, по которой считались параметры поляризации;
DTBSPTR - указатель на таблицу типа PMINFO, в которую и будут записаны поляризационные параметры.

Таблица БД PMINFO.

При записи в таблицу БД типа PMINFO параметров поляризации в строке формируются значения следующих полей:

NMGL - номер магнитограммы;
HCAB - кабельная глубина;
XOP, YOP, ZOP - координаты пункта приема;
XSP, YSP, ZSP - координаты пункта взрыва;
FI, AZ - параметры поляризации (угол с вертикалью и азимут вектора подхода волны в сейсмоприемник);
E1, E2 - параметры эллиптичности;
TSTART - левая граница интервала расчета параметров (мс);
TLEN - длина окна расчета параметров (мс),
ENERGY - энергия трехкомпонентной записи в окне расчета.

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

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

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

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

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

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

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

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

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

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

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

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

Описание информационных сообщений.

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

"Creating new table 'VSP.xxx.xx.PMINFO.xx'": Сообщение о создании новой таблицы базы данных.

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

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

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

"Window's length must be greather than 0!": Длина окна расчета должна быть больше нуля.
"Couldn't open 'Sxxx' modification of input traces due to ERROR_IDENT": Сообщение о невозможности открыть входную модификацию с трассами.
"Could not open 'VSP.xxx' due to ERROR_IDENT": Сообщение о невозможности открыть таблицу БД.
"Could not create 'VSP.xxx' due to ERROR_IDENT": Сообщение о невозможности создать новую таблицу БД.
"Can't select input traces due to ERROR_IDENT": Во входной модификации нет актуальных трасс глубинного типа.
"Could not calculate polarization parameters at HCAB=%g NMGL=%d.Traces interval for calculation is empty.": Сообщение о невозможности произвести расчет параметров поляризации. Заданный интервал трассы состоит либо нулевой, либо состоит из нулевых трасс.
"There were __ warnings. Please check log file.": В процессе выполнения программы были некритические ошибки. Смотрите LOG файл.
"There were errors and no data was written to DB!": В процессе выполнения программы были ошибки и не сделано ни одной записи в БД.