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

Программа является 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 помещаются по завершении работы программы в область сообщений интерактивной оболочки.

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

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