← Назад

Импорт сейсмических трасс из файла VSP-PC .

Seismic traces import from VSP-PC file .

FROMVSPPC PEP-клиент.


Назначение.

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

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

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

Программа обеспечивает возможность продолжения обработки сейсмических данных, начатой в пакете VSP-PC под MS-DOS. В том случае, если паспорт (описание данных) в VSP-PC и UNIVERS одинаковы, то, пользуясь программами преобразования трасс между UNIVERS и VSP-PC, можно проводить совместную обработку данных. Возможные ограничения и проблемы с проведением совместной обработки в UNIVERS и VSP-PC перечислены в п.9 Руководства пользователя по программе "Экспорт сейсмических трасс в файл VSP-PC".

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


Описание.

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

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

  1. Запуск программы из меню пакета UNIVERS (Data import -> Seismic traces import from VSP-PC file).
  2. Задание проекта, в который будет помещена сформированная модификация (пункт меню File -> Project...).
  3. Выбор пути и имени файла VSP-PC, подлежащего траснформации в модификацию UNIVERS (параметр Input VSP-PC data file).
  4. Задание выходной модификации UNIVERS. (параметр Output modification).
  5. Указание типа трасс, которые будут сформированы в модификации UNIVERS. В большинстве случаев достаточно будет указать As in file.
  6. Запуск программы на выполнение (кнопка Start в панели инструментов или пункт меню FROMVSPPC -> Start).
  7. Пользователь может следить за ходом работы программы по прогресс-индикатору на панели выполнения.
  8. После успешного завершения программы программа должна вернуть код 0, в информационых строках не должно быть сообщений об ошибках и в панели результатов (Results) должны присутствовать: число трасс, записанных в модификацию, ее имя и две строки из входного файла VSP-PC, идентифицирующие программу, создавшую исходный файл VSP-PC. Рядом с именем выходной модификации можно нажать кнопку View и просмотреть импортированные трассы.
  9. Для просмотра протокола прохождения программы надо нажать кнопку View log в панели инструментов или выбрать пункт меню FROMVSPPC -> View log. В протоколе содержится информация из прочитанных заголовков.
  10. Для выхода из среды пакетного запуска нужно нажать кнопку Exit в панели инструментов или выбрать пункт меню File -> Exit.


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

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

Input VSP-PC data file
Входной файл трасс формата VSP-PC. Следует указать именно файл трасс, а не файл таблицы PROF, расположенный в одноименном каталоге и имеющий имя, совпадающее с именем файла данных. Все трассы из указанного файла данных будут записаны в выходную модификацию. Традиционно имя файла трасс VSP-PC должно удовлетворять маске pv---m--.v--, где - - цифра.
Output modification
Выходная модификация. Будет содержать все трассы из указанного входного файла.
Type of traces
Тип трасс в выходной модификации:
As in file
Такой-же, как и во входном файле. Следуется указываться для трасс глубинного и контрольного прибора (в том числе, если они смешаны во входном файле). Правильное распознание вспомогательных каналов происходит только в том случае, если в файле VSP-PC отметка момента обозначена как "om", а вертикальное время как "tv".
Time break
Принудительная установка всех трасс в выходной модификации, как трассы с отметкой момента.
Uphole time
Принудительная установка всех трасс в выходной модификации, как трассы с вертикальным временем.


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

Progress of trace conversion
Визуально показывает долю конвертированных трасс.
Stage of processing
Этапы выполнения программы:
Opening input data...
Открытие вхого файла трасс VSP-PC.
Creating output modification...
Создание выходной модификации.
Writing output data...
Преобразование и запись трасс в выходную модификацию.


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

Total number of traces
Число трасс, записанных в выходную модификацию.
Output modification
Имя выходной модификации.
Program which created VSP-PC file
Имя программы, создавшей входной файл. Обычно это одна из программ комплекса обработки VSP-PC или программа TOVSPPC пакета UNIVERS.
Comment from VSP-PC file
Комментарий, который записала программа, создавшая входной файл. Часто это фраза на русском языке.


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

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


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

Трассы.

Входом программы является файл трасс VSP-PC. Файл траблицы PROF программой не используется. Программа обеспечивает импорт трасс с отсчетами следующих форматов: Int2, Int4, Real4, Real8. Форматы Real2, Real10 не поддерживаются.

Трассы с именами компонент "om" и "tv" распознаются как трассы отметки момента и вертикального годографа.

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

Трассы.

Выходом программы является модификация трасс, пригодная для обработки в пакете UNIVERS. Однако поскольку эта модификация введена в обход программ паспортизации, возможно ее несоответствие другим данным проекта. Важными атрибутами, определяющими совместимость файла трасс с другими данными проекта являются номера магнитограмм (NMGL), номера трасс (NTR), типы приборов и имена компонент (TYPE, COMP), кабельные глубины (HCAB) и координаты (XSPV, YSPV, ZSPV, XOPV, YOPV, ZOPV).

Формат отсчетов в выходной модификации - Real4 независимо от входного формата.

Правило формирования заголовка трассы (UNIVERS <- VSP-PC):

  • SIZE <- 60
  • FTR <- Real4
  • TBC <- Tbeg
  • TEC <- Tend
  • DT <- Tdt
  • NMGL <- Fmg
  • NTR <- Ntr
  • ACT <- 1
  • NMGF <- Fmg
  • XSP <- Xsp
  • XDP <- Xdp
  • XOP <- Xpp
  • TBA <- Tspl
  • TEA <- Tepl + Tdt
  • NSP <- Nsp
  • YSP <- Ysp
  • YDP <- Ydp
  • YOP <- Ypp
  • TRFR <- Fmg
  • XSPV <- Xsp
  • YSPV <- Ysp
  • ZSPV <- Zsp
  • XOPV <- Xpp
  • YOPV <- Ypp
  • ZOPV <- Zpp
  • XDPV <- Xdp
  • YDPV <- Ydp
  • ZDPV <- Zdp
  • HCAB <- Hcab
  • WCODE <- "" - пустой идентификатор скважины
  • STATCOR <- 0. - статическая поправка
  • В зависимости от выбранного типа трасс:
    As in file
    Если Elem = "om" то COMP[0]='B' и TYPE[0]='A'
    Если Elem = "tv" то COMP[0]='U' и TYPE[0]='A'
    Иначе COMP[0] <- Elem[0] и
    • Если Type=0 то TYPE[0]='D'
    • Если Type=1 то TYPE[0]='C'
    • Если Type=2 то TYPE[0]='S'
    Time break
    COMP[0]='B' и TYPE[0]='A'
    Uphole time
    COMP[0]='U' и TYPE[0]='A'


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

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

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


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

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

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

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

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

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


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

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


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

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

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


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

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

Ниже приводится пример протокола прохождения с комментариями.

INFO: Job number is 1. INFO: Developer's level of the session is 1. INFO: Start of FROMVSPPC application. INFO: Version: unknown. INFO: Project: 200_9 INFO: Moment: 2001/02/14 17:57:25
Типовой заголовок протокола работы программы с указанием имени приложения, его версии, проекта и времени.
INFO: ********************* INFO: * Trace file header * INFO: ********************* INFO: File signature: VSP-PC INFO: File header size: 90 INFO: Date of creation: 02/02/01 INFO: Name of this file: pv001m01.v00 INFO: Source file name: Диск INFO: Creator program name: LPRI INFO: Comment: Формир-ние модификации профиля
Распечатка информации, имеющейся в заголовке файла VSP-PC.
INFO: ************** INFO: * Trace 0001 * INFO: ************** INFO: Trace header size (bytes): 80 INFO: Shot point coordinate (X, Y, Z): -9.69691 -103.547 50 INFO: Receiver point coordinate (X, Y, Z): 0 0 2400 INFO: Deep point coordinate (X, Y, Z): 0 0 0 INFO: Cable depth: 2400 INFO: Time of first sample: 0 INFO: Time of last sample: 2999 INFO: Time of first useful sample: 0 INFO: Time of last useful sample: 2999 INFO: Sampling rate (ms): 1 INFO: Shot point number: 1 INFO: Shot point number: 1 INFO: Field record number: 1 INFO: Trace number within field record: 1 INFO: Code of trace: 3286 INFO: Type of trace: downhole device INFO: Component: 'z' INFO: Number of static corrections for shot point: 0 INFO: Number of static corrections for receiver point: 512 INFO: Sample format: Floating point 4 bytes
Распечатка прочитанного заголовка трассы VSP-PC.
INFO: End of FROMVSPPC application. INFO: Moment: 2001/02/14 17:57:29
Метка окончания задания с указанием времени.


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

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

"ERROR: Can't open input file '/path/pv---m--.v--' due to some-error."
Ошибка открытия входного файла. Проверьте правильность задания имени файла. В UNIX имена файлов различаются, если они набраны в разном регистре (большими и маленькими буквами).
"ERROR: File header reading failed due to ERROR_IDENT"
Ошибка при чтении заголовка файла. Вероятная причина - неправильный формат файла.
"ERROR: Can't read trace #NNN header."
Ошибка при чтении заголовка трассы с указанным номером. Убедитесь, что в качестве входного файла задан файл сейсмических трасс, а не файл таблицы PROF.
"ERROR: Can't convert sample format: possible bad file format."
Ошибка при преобразовании формата отсчетов. Вероятная причина - неправильный формат файла.
"ERROR: Can't allocate NNN bytes: possible bad file format."
Невозможно выделить указанное количество байт памяти. Вероятная причина - неправильный формат файла.
"ERROR: Can't create modificaiton 'Sxxx' due to ERROR_IDENT."
Ошибка создания выходной модификации.
"ERROR: Can't allocate trace buffer (NNN bytes)."
Не удалось выделить указанное количество байт памяти.
"ERROR: Reading trace #NNN failed due to ERROR_IDENT."
Ошибка при чтении указанной трассы. Вероятная причина - неправильный формат файла.
"ERROR: Trace #NNN writing failed due to ERROR_IDENT"
Ошибка при записи трассы в выходную модификацию.
"WARNING: Samples conversion error for trace #NNN."
Замечены проблемы при преобразовании тела указанной трассы. Полученное в результате тело трассы, несмотря на замеченные ошибки преобразования, было записано в выходную модификацию. Рекомендуется найти эту трассу в файле и детально изучить ее содержимое с целью выяснения причин.


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

  • Программа преобразует многосимвольные компоненты VSP-PC в односимвольную компоненту UNIVERS, переводя первый символ компоненты в верхний регистр. Исключение составляют компоненты "om" и "tv", преобразуемые в компоненты 'B' и 'U' вспомогательного прибора.
  • Программа не использует данные из таблицы PROF, поэтому информация о методике наблюдения (типы магнитограмм, многоточечные зонды) теряется. Фактически, корректно могут быть преобразованы только данные одноточечного зонда.


Ссылки.

Программы и документы.

Контакты
198188 Санкт-Петербург, ул. Зайцева, д. 41, офис 263
Телефоны:
+7 (495) 754-9990
+7 (903) 255-7275
+7 (911) 236-7708
e-mail:
vsp@geovers.com
© ООО Геоверс, 2001-2024