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

Determination of borders orientation.

DIP PEP-клиент

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

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

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

Для работы программы необходима скоростная модель расчитанная по годографу первых вступлений программой построения кинематической модели среды FBVEL2, таблицы параметров поляризации расчитанных программой POL по полям падающих и отраженных волн разделенных программой селекции SUBCOR . Рекомендуется выбирать длину интервала расчета параметров поляризации отраженной волны примерно равной длине интервала расчета параметров поляризации падающей волны. Для разделения волн используется поле, ориентированное в географическую систему координат программой SPIN .

Описание.

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

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

Запуск программы из меню пакета ВСП.
Задание проекта, в каталоге данных которого находится исходная модификация (пункт меню File -> Project...);
Задание априорной скоростной модели среды (поле Input table with velocity model);
Задание параметров поляризации падающей волны (поле Input table with downgoing wave polarization);
Задание параметров поляризации отраженной волны (поле Input table with upgoing wave polarization);
Задание таблицы базы данных, в которую будут записаны полученные углы и азимуты наклона границ и другие результаты работы программы (поле Output table with dip parameters);
Запуск программы на выполнение (кнопка Start в панели инструментов или пункт меню DIP -> Start).
На "бегунке" Done traces отображается относительное количество обработанных точек приема.
Для просмотра протокола прохождения программы надо нажать кнопку View log в панели инструментов или выбрать пункт меню DIP -> View log.
Для выхода из среды пакетного запуска нужно нажать кнопку Exit в панели инструментов или выбрать пункт меню File -> Exit.

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

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

Input table with velocity model: Имя: in_dbmodel
Тип: dbname_s(MOD1DLIST)
Описание: Априорная скоростная модель среды
Input table with upgoing wave polarization: Имя: pol_down
Тип: dbname_s(PMLIST)
Описание: Параметры поляризации падающей волны
Input table with upgoing wave polarization: Имя: pol_up
Тип: dbname_s(PMLIST)
Описание: Параметры поляризации отраженной волны. Рекомендуется выбирать длину интервала расчета параметров поляризации отраженной волны примерно равной длине интервала рассчета параметров поляризации падающей волны.
Output table with dip parameters: Имя: out_dbmodel
Тип: dbitem_e(VSP.BOLIST)
Описание: Результат работы программы

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

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

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

Output table with dip parameters: Имя: out_dbmodel
Тип: dbname_s(BOLIST)
Описание: Таблица с углами и азимутами наклона границ.

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

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

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

Таблицы БД.

Для работы программы необходимы таблица базы данных с информацией о пластовой скоростной модели среды типа MOD1DINFO, а также таблицы с параметрами поляризации падающей и отраженной волн типа PMINFO.

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

Таблицы БД.

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

Таблица БД BOLIST.

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

NVAR - уникальный номер варианта таблицы параметров;
COMMENT - комментарий (программой не заполняется);
DTBSPTR - указатель на таблицу типа BOINFO, в которую и будут записаны поляризационные параметры.

Таблица БД BOINFO.

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

HCAB - кабельная глубина трассы по которой расчитаны параметры поляризации;
ZV - географическая глубина наблюдений;
ZR - глубина отражения;
FI, AZ - угол и азимут наклона границы;
ED, EU - энергия падающей и отраженной волн в интервале расчета параметров поляризации.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

"A-priori model not opened. Error '%s'. Project '%s'": Сообщение о невозможности открыть априорную пластовую скоростная модель.
"Could not open DB table %s. Error '%s'": Сообщение о невозможности открыть таблицу-список с информацией о наклонах границ.
"Could not create DB table %s. Error '%s'",: Сообщение о невозможности создать новую таблицу БД с информацией о параметрах наклона границ.
"Could not re-create DB table %s. Error '%s'",: Сообщение о невозможности пересоздать таблицу БД с информацией о параметрах наклона границ.
"Could not open input DB table %s. Error '%s'",: Сообщение о невозможности открыть таблицу БД с информацией о параметрах поляризации падающей или отраженной волны.
"DB table PMINFO: Could not find a DB entry for depth %d",: Не совпали глубины в таблицах с параметрами поляризации падающей и отраженной волны.
"Downgoing wave angle out of range",: Недопустимое значение параметра поляризации падающей волны.
"Upgoing wave angle out of range",: Недопустимое значение параметра поляризации отраженной волны.
"Incorrect parameters of polarisation waves",: Параметры поляризации падающей и отраженной волн совпадают.
"Wrong quantity layers in model",: Некорректное число слоев в модели.
"Wrong velocity",: Некорректные значения скоростей.
"Wrong parameters TSTART or TLEN in table PMINFO",: Некорректные параметры TSTSRT или TLEN в таблице PMINFO. Время отраженной волны меньше времени падающей волны.
"Wrong angle FI in table PMINFO",: Некорректен угол FI поляризации падающей волны.
"Wrong depth layers in velocity model",: Ошибка в глубинах скоростной модели.
"Depth observation point is out of range depth velocity model",: Точка регистрации вне интервала скоростной модели.