← Назад 
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.  Типовой сеанс работы
состоит из следующих шагов:
-  Запуск программы из меню пакета UNIVERS (Data import -> Seismic
traces import from VSP-PC file).
 -  Задание проекта, в который будет помещена сформированная модификация (пункт
меню File -> Project...).
 -  Выбор пути и имени файла VSP-PC, подлежащего траснформации в модификацию UNIVERS (параметр Input VSP-PC data file).
 -  Задание выходной модификации UNIVERS.  (параметр Output
modification).
 -  Указание типа трасс, которые будут сформированы в модификации UNIVERS.
В большинстве случаев достаточно будет указать As in file.
 -  Запуск программы на выполнение (кнопка Start в панели инструментов
или пункт меню FROMVSPPC -> Start).
 -  Пользователь может следить за ходом работы программы по
прогресс-индикатору на панели выполнения.
 -  После успешного завершения программы программа должна вернуть код 0, в
информационых строках не должно быть сообщений об ошибках и в панели результатов
(Results) должны присутствовать: число трасс, записанных в модификацию,
ее имя и две строки из входного файла VSP-PC, идентифицирующие программу,
создавшую исходный файл VSP-PC.  Рядом с именем выходной модификации можно
нажать кнопку View и просмотреть импортированные трассы.
 -  Для просмотра протокола прохождения программы надо нажать кнопку View
log в панели инструментов или выбрать пункт меню FROMVSPPC -> View
log.  В протоколе содержится информация из прочитанных заголовков.
 -  Для выхода из среды пакетного запуска нужно нажать кнопку Exit в
панели инструментов или выбрать пункт меню File -> Exit.
 
-  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
 -  Принудительная установка всех трасс в выходной модификации, как трассы с
вертикальным временем.
 
 
-  Progress of trace conversion
 -  Визуально показывает долю конвертированных трасс.
 -  Stage of processing
 -  Этапы выполнения программы:
-  Opening input data...
 -  Открытие вхого файла трасс VSP-PC.
 -  Creating output modification...
 -  Создание выходной модификации.
 -  Writing output data...
 -  Преобразование и запись трасс в выходную модификацию.
 
 
-  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.
 Программа загружает умолчательные значения параметров из специальных файлов
в следующем порядке:
-  $VSPHOME/app-defaults/FROMVSPPC.parameters.def - общесистемный каталог
умолчательных значений параметров.
 -  JOBS/$PROJECT/FROMVSPPC.parameters.def - каталог заданий текущего
проекта.
 -  $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, поэтому информация о
методике наблюдения (типы магнитограмм, многоточечные зонды) теряется.
Фактически, корректно могут быть преобразованы только данные одноточечного
зонда.
 
 
-  Экспорт сейсмических трасс в файл VSP-PC 
TOVSPPC.
 -  Форматы файлов сейсмических данных: