← Назад
Mute PEP-клиент.
Программа предназначена для обнуления (мютинга) файла трасс вдоль указанного
годографа. Годограф считывается из базы данных. Относительно него задается
окно, образуемое левой и правой границами внутри которого значения амплитуд
отсчетов не изменяются. Дополнительно для каждой границы задается интервал, на
котором производится плавный спад амплитуды (по закону косинуса). Все отсчеты
трасс вне заданного окна обнуляются.
Программа является PEP-клиентом, то есть, она запускается из-под оболочки
пакетного запуска pktexec, предоставляющей
сервис по заданию параметров, управлению выполнением и просмотру протокола
работы программы.
Задание параметров и запуск программы происходит из-под оболочки пакетного
запуска pktexec. Типовой сеанс работы
состоит из следующих шагов:
- Запуск программы из меню пакета ВСП.
- Задание проекта, в каталоге данных которого находится исходная модификация
(пункт меню File -> Project...).
- Задание исходной и выходной модификаций а также выбор таблицы, в которой
находятся времена первых вступлений.
- Задание левой и правой границ окна, значений интервалов плавного спада, а
также диапазон кабельных глубин, для всех трасс которого применяется мьютинг.
- Запуск программы на выполнение (кнопка Start в панели инструментов
или пункт меню Mute -> Start).
- Для просмотра результирующей модификации надо нажать кнопку View
у имени выходной модификации в панели результатов.
Для просмотра протокола прохождения программы надо нажать кнопку View
log в панели инструментов или выбрать пункт меню Mute -> View
log.
- Для выхода из среды пакетного запуска нужно нажать кнопку Exit в
панели инструментов или выбрать пункт меню File -> Exit.
- Имя: Data modification for muting
Тип: nmod_s
Описание: Имя модификации с трассами, подаваемыми на вход программы.
- Имя: Resulting data modification
Тип: nmod_e
Описание: Имя выходной модификации. Имя должно быть задано в форме
Sxxx, где xxx - цифры. В эту модификацию будут записаны все актуальные входные
трассы, причем трассы, попавшие в указанный диапазон кабельных глубин, будут
обнулены вдоль годографа.
- Имя: Time hodograph
Тип: dbname_s(FBLIST)
Описание: Таблица БД с временным годографом, вдоль которого будет производится
обнуление. За время годографа принимается поле TFB таблицы БД.
- Имя: Switcher of inverse muting
Тип: state
Описание: Включение обратного мьютинга (восстановление амплитуд).
- Имя: Switcher of left-side muting
Тип: state
Описание: Включение мьютинга слева от годографа.
- Имя: Left boundary shift, ms
Тип: float
Описание: Левая граница области сохранных отсчетов.
- Имя: Width of left-side fading slope, ms
Тип: float
Описание: Ширина склона спада от левой границы влево.
- Коэффициэнты рассчитываются по косинусоидальному закону в интервале
0 - 180 градусов в пределах ширины области спада. Полученные значения
косинусов умножаются на минус единицу. Затем к этому значению прибавляется
единица и результат делится на два. Все значения трасс в области спада
умножаются на соответствующий коэффициэнт. При обратном мютинге
рассчитывается обратный коэффициэнт по формуле cb = 1.01 / (cr + 0.01),
- где cb - обратный коэффициэнт
cr - прямой коэффициэнт
- Имя: Apply to depths: (start end)
Тип: float2
Описание: Кабельные глубины трасс, к которым будет применен мьютинг слева от
годографа. Второе значение глубины должно быть меньше или равно первому.
- Имя: Switcher of right-side muting
Тип: state
Описание: Включение мьютинга справа от годографа.
- Имя: Right boundary shift, ms
Тип: float
Описание: Правая граница области сохранных отсчетов.
- Имя: Width of right-side fading slope, ms
Тип: float
Описание: Ширина склона спада от правой границы вправо.
- Коэффициэнты рассчитываются по косинусоидальному закону в интервале
0 - 180 градусов в пределах ширины области спада.
Затем к этому значению прибавляется единица и результат делится на два.
Все значения трасс в области спада умножаются на соответствующий коэффициэнт.
При обратном мютинге рассчитывается обратный коэффициэнт по формуле
cb = 1.01 / (cr + 0.01),
- где cb - обратный коэффициэнт
cr - прямой коэффициэнт
- Имя: Apply to depths: (start end)
Тип: float2
Описание: Кабельные глубины трасс, к которым будет применен мьютинг справа от
годографа. Второе значение глубины должно быть меньше или равно первому.
-
- Имя: Current cable depth
Тип: float
Описание: Текущая кабельная глубина обработанной трассы
-
- Имя: Resulting data modification
Тип: nmod_s
Описание: Имя выходной модификации
- Имя: Count of all input traces
Тип: int
Описание: Общее количество поданных на вход трасс.
- Имя: Count of written traces
Тип: int
Описание: Количество трасс, записанных в выходную модификацию.
Для детального ознакомления с пользовательским интерфейсом оболочки
пакетного запуска, смотри описание программы
pktexec. Ниже приводится пример окна оболочки с активной панелью
ввода параметров:
На вход программы подаются все трассы указанной модификации. К обработке
принимаются только актуальные трассы (ACT!=0). К трассам, попавшим в диапазон
левостороннего и/или правостороннего мьютинга, применяется процедура обнуления с
плавным спадом. Актуальные трассы, не попавшие в диапазон ни в один из
диапазонов кабельных глубин, все равно записываются в исходном порядке в
выходную модификацию. Выходная модификация не может совпадать c входной.
Годограф читается из таблицы типа FBINFO. При этом время годографа берется
из поля TFB, а сопоставление точки годографа и трассы производится по совпадению
полей HCAB и NMGL соответствующим полям заголовка тела рассматриваемой трассы.
В результирующий файл с именем выходной модификации записываются все
актуальные трассы, значения отсчетов которых изменены в соответствии с
заданием.
Программа получает имя рабочего проекта через переменную среды PROJECT. В
случае запуска программы из-под оболочки, это условие выполняется путем выбора
рабочего проекта.
Программа определяет местонахождение системных файлов пакета из переменной
VSPHOME, определенной в профиле пользователя или в файле setup в домашнем
каталоге пользователя пакета. Файле setup данная переменная может
выступать также под именем VSP.
Программа ищет описание параметров в файлах $VSPHOME/etc/Mute.pep и
$VSPHOME/etc/vsp.pep.
В домашнем каталоге пользователя должен присутствовать файл setup,
содержащий пути к каталогам данных, заданий и протоколов прохождения проектов, а
также пути к системным файлам пакета ВСП.
Прочие требования накладываются оболочкой пакетного запуска pktexec.
Все сообщения выводятся в стандартный поток ошибок. В случае запуска
программы из-под интерактивной оболочки сообщения сохраняются в файле протокола
прохождения задания LOG/$PROJECT/Mute-#.log. Сообщения классов серьезности
EL_FATAL и EL_ERROR помещаются по завершении работы программы в область
сообщений интерактивной оболочки.
