Создание архива обработки.

Решаемые задачи и метод.

Программа предназначена для создания архива обработки заданного проекта в разделе ARCHIVE. В состав архива включаются:

Все таблицы базы данных (файлы VSP.*)
Перечисленные в параметрах сейсмические модификации, переименованные в указанные имена вместе с соответствующими таблицами модификаций.
Файлы SEG-Y (с расширением .sgy), автоматически генерируемые по архивируемым модификациям.

Указанные пользователем идентификационные данные (названия компании-заказчика, подрядчика, площади и номер скважины) вместе с двумя строками комментариев помещаются в текстовый заголовок каждого из создаваемых файлов SEG-Y. Кроме того, в каждый из файлов помещается его идентификатор - строка, описывающая вид информации представленный в файле. Эта строка является копией названия входного параметра.

Список и типы архивируемых сейсмических модификаций можно изменить. Для этого необходимо отредактировать в текстовом редакторе файл $VSPHOME/etc/MakeArch.pep. Подробные инструкции данной операции изложены в п. 9.

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

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

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

Описание.

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

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

Запуск программы из меню пакета UNIVERS (Service tools -> Create archive of processing).
Задание проекта, архив обработки которого необходимо создать (пункт меню File -> Project...).
Ввод идентифицирующих данных о проекте (параметры Client name, Company name, Well number и Area name), а также дополнительных комментариев Additional comment line #1 и Additional comment line #2. Параметры являются необязательными.
Задание сейсмических модификаций, помещаемых в архив (параметр Initial wavefield with control device [S000] и т. п.). Все параметры являются необязательными.
Запуск программы на выполнение (кнопка Start в панели инструментов или пункт меню MakeArch -> Start).
Пользователь может следить за ходом работы программы по прогресс-индикатору на панели выполнения, обозначающему количество скопированных файлов.
После успешного завершения программы программа должна вернуть код 0, в информационых строках не должно быть сообщений об ошибках и в панели результатов (Results) должны присутствовать: размер архива в мегабайтах и количество ошибок.
Для просмотра протокола прохождения программы надо нажать кнопку View log в панели инструментов или выбрать пункт меню MakeArch -> View log. В протоколе содержится информация о сформированных заголовках.
Для выхода из среды пакетного запуска нужно нажать кнопку Exit в панели инструментов или выбрать пункт меню File -> Exit.

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

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

Client name: Название компании-клиента (client)
Company name: Название компании-подрядчика (company)
Well number: Номер скважины (wellnum)
Area name: Название площади или месторождения (area)
Additional comment line #1: Дополнительный комментарий (comment2)
Произвольный комментарий, помещаемый в 24-ю строку текстового заголовка файла SEG-Y.
Additional comment line #2: Дополнительный комментарий (comment3)
Произвольный комментарий, помещаемый в 25-ю строку текстового заголовка файла SEG-Y.
: В описанных ниже параметрах в квадратных скобках приводятся стандартные имена модификаций в которые переименовываются указанные пользователем.
Initial wavefield with control device [S000]: Исходное волновое поле с контрольным прибором (nmod_s000)
Initial wavefield after orientation (X,Y,Z) [S001]: Исходное волновое поле после ориентации (nmod_s001)
Downgoing P waves [S011]: Поле падающих продольных волн (nmod_s011)
Upgoing P waves [S012]: Поле отраженных продольных волн (nmod_s012)
Upgoing SV waves [S013]: Поле отраженных поперечных волн (nmod_s013)
Downgoing waves after spike deconvolution [S021]: Падающая волна после пиковой деконволюции (nmod_s021)
Upgoing P waves after spike deconvolution [S022]: Отраженная продольная волна после пиковой деконволюции (nmod_s022)
Upgoing P waves after kinematic correction [S023]: Отраженная продольная волна после кинематической коррекции (nmod_s023)
Upgoing SV waves after spike deconvolution [S024]: Отраженная поперечная волна после пиковой деконволюции (nmod_s024)
VSP-CDP image in depth scale for P waves [S025]: Изображение ВСП-ОГТ в глубинном масштабе на продольных волнах (nmod_s025)
VSP-CDP image in time scale for P waves [S026]: Изображение ВСП-ОГТ во временном масштабе на продольных волнах (nmod_s026)
VSP-CDP image in depth scale for SV waves [S027]: Изображение ВСП-ОГТ во временном масштабе на поперечных волнах (nmod_s027)
VSP-CDP image in time scale for SV waves [S028]: Изображение ВСП-ОГТ во временном масштабе на поперечных волнах (nmod_s028)
Primary reflections trace [S055]: Трасса однократных отражений (nmod_s055)
Primary reflections trace after deconvolution [S066]: Трасса однократных отражений после деконволюции (nmod_s066)
Acoustic impedance [S067]: Акустический импеданс (nmod_s067)

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

Stage of processing: Стадия обработки данных (stage)
Data object: Текущий архивируемый файл базы данных или модификация (dobj)
Processed number of files: Количество обработанных файлов (runner)

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

Total size of archive, Mb: Суммарный размер архива в мегабайтах (arcsize)
Number of errors while making archive (see log): Число файлов, для которых операция архивирования закончилась с ошибкой (failed)

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

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

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

Трассы.

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

Таблицы БД.

На вход программы подаются все таблицы базы данных UNIVERS текущего проекта.

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

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

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

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

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

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

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

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

Программа загружает умолчательные значения параметров из специальных файлов в следующем порядке:

$VSPHOME/app-defaults/MakeArch.parameters.def - общесистемный каталог умолчательных значений параметров.
JOBS/$PROJECT/MakeArch.parameters.def - каталог заданий текущего проекта.
$HOME/.vsp/MakeArch.parameters.def - каталог пользовательских настроек.

Таким образом, пользовательские настройки имеют приоритет над общесистемными и проектными.

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

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

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

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

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

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

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

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

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

Особенности использования.

Пользователь имеет возможность изменить список модификаций и их новые номера, получаемые в процессе архивации проекта. Для этого необходимо воспользоваться любым текстовым редактором, работающим с обычными текстовыми файлами. Редактировать следует файл $VSPHOME/etc/MakeArch.pep.

Редактировать разрешается только строки, расположенные между метками "*** BEGIN ***" и "*** END ***". Для того, чтобы строка воспринималась программой как корректный параметр, она состоять из четырех полей, разделенных пробелами или табуляциями:

Имя параметра должно начинаться с nmod_s и быть уникальным в перечне.
Тип параметра должен быть обязательно nmod_s
Комментарий, помещаемый в файл должен быть ограничен двойными кавычками и содержать внутри себя в квадратных скобках новое имя модификации, получаемое после архивации в формате Sxxx, где xxx - любые три цифры.
Последнее поле является строкой, выдаваемой в качестве подсказки. Строка ограничивается двойными кавычками и может быть пустой.

Описание каждого параметра должно занимать одну строку - переводы строки недопустимы! Количество параметров не ограничено.

Внимание! При изменении списка модификаций возможно некорректное поведение системы оперативной справки по программе. Однако это не влияет на работоспособность программы.