← Назад

Линейная нормировка трасс.

Gain traces normalization.

Gain PEP-клиент.


Назначение.

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

Программа предназначена для линейной нормировки трасс. Каждый отсчет трассы в пределах полезных времен умножается на заданный коэффициент. Возможна нормировка только только трасс с заданным номером.

При задании коэффициэнта равным нулю, возможно обнулять трассы.
При задании коэффициэнта равным -1, изменяется полярность трасс.


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

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


Описание.

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

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

  1. Задание проекта, в каталоге данных которого находится исходная модификация (пункт меню File -> Project...).
  2. Запуск программы из меню пакета ВСП.
  3. Задание номеров трасс, для которых нужно выполнить нормировку. Если нормировка должна выполняться для всех трасс, это поле должно быть пустым. Правила заполнения поля: Все номера задаются списком и отделяются друг от друга запятыми. Если необходимо задать несколько трасс подряд, можно указать первый и последний номер через черточку. Например 1-9. В этом случае будут выбраны трассы с 1-й по 9-ю. Если нужно выбрать номера трасс с определенным шагом, можно задать их в виде N1*NN,stN где N1 - номер первой трассы, NN - количество циклов повторений данной операции, stN - шаг приращения предыдущего номера трассы для получения следующего номера. Например 1*8,1 В этом случае будет выбрана 1-я трасса, затем 8 раз будут выбраны следующие трассы с номером отличающемся от предыдущего на единицу, т.е. будут выбраны те же номера с 1-й по 9-ю трассы.
  4. Задание коэффициента нормализации. Обычно коэффициент >0 и <1 чтобы уменьшить амплитуду после выполнения некоторых обрабатывающих программ. Если коэффициент <0, происходит изменение полярности трасс. Если коэффициент равен нулю, происходит обнуление трасс.
  5. Запуск программы на выполнение (кнопка Start в панели инструментов или пункт меню Gain -> Start).
  6. Для просмотра результирующей модификации надо нажать кнопку View у имени выходной модификации в панели результатов.

    Для просмотра протокола прохождения программы надо нажать кнопку View log в панели инструментов или выбрать пункт меню Gain -> View log.

  7. Для выхода из среды пакетного запуска нужно нажать кнопку Exit в панели инструментов или выбрать пункт меню File -> Exit.


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

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

Имя: Data modification for gain
Тип: nmod_s
Описание: Имя входной модификации
Имя: Resulting data modification
Тип: nmod_e
Описание: Имя выходной модификации. Имя должно быть задано в форме Sxxx, где xxx - цифры.
Имя: Parametrs for gain
Тип: float
Описание: Нормирующий коэффициент.


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

Имя: Current cable depth, m
Тип: float
Описание: Текущая кабельная глубина обработанной трассы


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

Имя: Resulting data modification
Тип: nmod_s
Описание: Имя выходной модификации
Имя: Count of all input traces
Тип: int
Описание: Счетчик входных трасс
Имя: Count of actual input traces
Тип: int
Описание: Счетчик выходных трасс


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

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


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

Трассы.

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


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

Трассы.

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


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

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

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

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


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

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

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


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

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


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

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

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

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

В протоколе прохождения задания появляются следующие сообщения:
"Trace NMGL=%d is skipped as not actual"
Не актуальная трасса в магнитограмме пропущена
"Trace NMGL=%d NTR=%d HCAB=%g is processed."
Обработана трасса nn в магнитограмме kk для кабельной глубины hh
"Trace NMGL=%d NTR=%d HCAB=%g is skipped."
Пропущена трасса nn в магнитограмме kk для кабельной глубины hh

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

"Can not open '%s' modification. Error #%d"
Ошибка при открытии исходной модификации (см. список ошибок).
"Can not create '%s' modification Error #%d"
Ошибка при создании результирующей модификации (см. список ошибок).
"There are errors in input parameters."
Встречены ошибки при диагностике задания.
"Can not allocate memory buffer for gain."
Система не смогла выделить память для работы.
Контакты
198188 Санкт-Петербург, ул. Зайцева, д. 41, офис 263
Телефоны:
+7 (495) 754-9990
+7 (903) 255-7275
+7 (911) 236-7708
e-mail:
vsp@geovers.com
© ООО Геоверс, 2001-2024