First break determination.

Определение годографа первых вступлений.

Основной задачей программы является определение годографа первого вступления. Наряду с ним определяются ряд вспомогательных параметров, характеризующих трассу: времена характерных точек вблизи полупериода первого вступления, оценки смещения нуля и отношения сигнал/шум, максимальные амплитуды трасс.

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

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

Программа определения первого вступления сохраняет результаты своей работы в таблицах БД типа FBINFO. Годограф первого вступления используется в программах накапливания (PStack), кинематического анализа (FBVEL2). Волновой годограф используется для задания направления волны в программах вычитания (SUBCOR) и предсказательной деконволюции (xprd).

3. Описание.

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

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

$ PROJECT=TEST FBD S100

Ниже приводятся два типовых сеанса работы.

3.1.1. Определение годографа первого вступления.

Дано: Имеется набор трасс ВСП, содержащих падающую волну (возможно, многокомпонентный и с кратностью отличной от 1).
Цель: Получить годограф первого вступления (годограф падающей волны).
Шаги:

Загрузить исходный набор трасс (меню File -> Open), выбрав в появившемся диалоговом окне проект и модификацию.
Запустить автоматическое определение годографа первого вступления (меню Hodographs -> Determine). Для этого в диалоговом окне надо указать тип прибора целевых трасс (глубинный или контрольный) и систему компонент (123 или XYZ). После чего надо нажать кнопку OK. Процесс определения первого вступления по трассам отображается на индикаторе, проградуированном от 0 до 100. По окончании процесса диалог автоматически закрывается, а на волновом поле цветом циан изображается рассчитанный годограф.
Для сильно зашумленного материала первый проход не даст удоволетворительного результата, поэтому может потребоваться задание априорного годографа первого вступления. Для этого надо перейти в режим линейки (Ruler mode), нажав кнопку . В этом режиме пользуясь мышью надо провести годограф зеленого цвета немного левее падающей волны. При этом узловые точки, задаваемые мышью, будут красного цвета. После этого надо снова запустить автоматическое определение годографа первого вступления (меню Hodographs -> Determine). В этом режиме имеет значение параметр "Search gap width". Он обозначает ширину области вправо от априорного годографа (в милисекундах) где программа будет искать первое вступление. Если полупериод первого вступления какой-либо трассы не попадет в коридор, задаваемый априорным годографом и шириной "Search gap width", то первое вступление будет определено неправильно или будет диагностировано отсутствие экстремума на рассматриваемом промежутке трассы. В остальном диалог с программой такой же, как и в предыдущем случае.
Рекомендуется пользуясь вертикальной полосой прокрутки в крупном масштабе просмотреть весь годограф чтобы убедиться в отсутствии сбоев в определенном годографе. Если программа не смогла правильно найти полупериод первого вступления, можно указать ей место, где его надо искать. Для этого надо перейти в режим подсказки интервала определения первого вступления (Hint mode), нажав кнопку . После этого надо указать на трассе интервал, охватывающий полупериод первого вступления, после чего программа скорректирует время годографа и прочие расчетные параметры для данной трассы.
В том случае, когда трасса зашумлена настолько, что форма сигнала в области первого вступления не дает никакой информации для расчета параметров, пользователь может задать время первого вступления и время пересечения нуля директивно. Для этого имеется соответствующий режим (Manual mode, директивный режим), включаемый кнопкой . Способ работы в этом режиме полностью эквивалентен режиму подсказки. Но заданный пользователем интервал интерпретируется программой по-другому: левая точка станет временем первого вступления TFB, правая - временем пересечения нуля TZERO.
Полученный таким образом годограф можно сохранить в базе данных (пункт меню Hodographs -> Save -> First break hodograph).

3.1.2. Получение волнового годографа.

Дано: Имеется набор трасс ВСП (возможно, многокомпонентный и с кратностью отличной от 1).
Цель: Получить годограф требуемой волны.
Шаги:

Загрузить исходный набор трасс (меню File -> Open), выбрав в появившемся диалоговом окне проект и модификацию.
Перейти в режим линейки и, проставляя мышью точки вдоль волны, провести волновой годограф. Он будет изображен зеленым цветом.

С помощью программы можно проводить только один непрерывный годограф. Годограф может прослеживаться как по всему интервалу кабельных глубин, так и по какому-то его диапазону.
Полученный волновой годограф можно сохранить в базе данных (пункт меню Hodographs -> Save -> Wave hodograph).

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

Процедура определения первого вступления имеет следующие числовые параметры, задаваемые в диалоге с заголовком "First break determination process":

Level of first break search: Уровень поиска полупериода первого вступления. Задается долей (0 .. 1) от амплитуды глобального экстемума. Используется только в автоматическом и полуавтоматическом режимах. Глобальный экстремум в автоматическом режиме ищется по всей трассе. В полуавтоматическом (в заданием примерного годографа) режиме берется экстремум того интервала трассы, который лежит вправо от годографа на уканное время. Поиск экстремума происходит слева направо по всей трассе (автоматический режим) или в интервале справа от априорного годографа (полуавтоматический режим). Чем ближе к нулю значение описываемого параметра, тем менее защищен алгоритм поиска полупериода первого вступления от случайных помех слева от времени первого вступления и более защищен справа от него. Данный параметр не используется в не автоматических режимах, поскольку в них пользователь сам указывает границы полупериода первого вступления.
Level of left coast meeting": Уровень пересечения левого склона полупериода первого вступления. Измеряется в долях (0 .. 1) от амплитуды полупериода первого вступления. В зависимости от режима работы (автоматический, полуавтоматический, с подсказкой) полупериод первого вступления может определяться различным образом. В автоматическом и полуавтоматическом режимах этот полупериод ищется на основе параметра Level of first break search. В режиме с подсказкой полупериод считается заданным пользователем. Значение данного параметра определяет насколько время первого вступления TFB будет близко к времени фазы TFBMX. Чем ближе значение параметра к единице, тем ближе будет TFB к TFBMX. Обычно задается значение от 0.05 до 0.15. На графике параметр отмечен буквой D.
Search gap width: Ширина интервала поиска первого вступления. Задается в милисекундах. Применяется только в полуавтоматическом режиме для задания интервала поиска глобального (на этом интервале) экстремума справа от априорного годографа. Если этот годограф проведен достаточно далеко от падающей волны и она не захватывается шириной поиска на некоторых кабельных глубинах, то на них алгоритм определения первого вступления будет давать сбои.

3.3. Режимы определения первого вступления.

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

3.3.1. Автоматический режим.

Действует для трасс, не пересекаемых априорным годографом. Запускается из меню (меню Hodographs -> Determine). Использует следующие параметры:

Level of first break search
Level of left coast meeting

3.3.2. Полуавтоматический режим.

Действует для трасс, пересекаемых априорным годографом. Запускается из меню (меню Hodographs -> Determine). Использует следующие параметры:

Level of first break search
Level of left coast meeting
Search gap width

3.3.3. Режим с подсказкой.

Включается кнопкой . Использует параметр Level of left coast meeting. Этот режим следует применять для отдельных трасс, имеющих сильные импульсные помехи вблизи первого вступления, превосходящие по амплитуде подающую волну. В этом случае два предыдущих режима не смогут правильно найти полупериод первого вступления. Суть режима в том, что пользователь указывает программе какой из полупериодов является искомым, а программа уже сама вычисляет все характерные времена и амплитуды.

3.3.4. Директивный режим.

Включается кнопкой . Не использует никаких дополнительных параметров. Этот режим целесообразно использовать в том случае если три предыдущих режима на смогли корректно определить время первого вступления для некоторых трасс. Суть режима в том что пользователь задает вручную два времени на трассе: время первого вступления TFB и время пересечения нуля TZERO. Остальные параметры рассчитываются автоматически.

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

3.4.1. Структура меню.

File

Open ... Close Exit

View Undo Redo Zoom in Zoom out Info mode Manual zoom... Zoom all Options... Hodographs Determine ... Shift First break hodograph Wave hodograph Save First break hodograph Wave hodograph Load First break hodograph Wave hodograph Clear First break hodograph Wave hodograph Ruler mode Hint mode Manual mode Help Context help User's guide

3.4.2. Пункты меню.

File -> Open

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

File -> Close

Закрытие модификации. Годографы очищаются. Запоминается область и режим визуализации закрытой модификации.

File -> Exit

Завершение работы программы. При этом у пользователя не спрашивается подтверждение. Поэтому следует сохранить рассчитанные годографы в базе данных заблаговременно.

View -> Undo

Откатка используется для восстановления предыдущих режимов визуализации или положения и размеров окна просмотра на поле трасс. Под окном просмотра понимается не то окно, которое занимает определенное место на вашем экране и может быль растянуто, передвинуто или иконизиравано, а виртуальное окно на поле трасс. Оно задается пользователем путем указания визуализируемых трасс и временного диапазона на них для отрисовки в пределах физического окна. Откатка осуществляется для внутренних параметров программы (ширина окна АРУ, способ зачернения) в отличие от внешних (размер окна программы). Поэтому, если вы измените размер окна программы на экране, а затем произведете откатку, она не восстановит предыдущий размер окна.

View -> Redo

Используется для восстановления параметров визуализации, потерянных в результате откатки. Имеет те же ограничения по области действия, что и откатка.

View -> Zoom in

Включение режима увеличивающей лупы. Выбор области, подвергаемой увеличению, осуществляется "резиновым" прямоугольником. Фиксация одного угла прямоугольника осуществляется нажатием кнопки 1 мыши. Далее указатель мыши перемещается для задания другого угла области. При этом выделенная область показываетя прямоугольником, отслеживающим перемещение указателя. Для фиксации другого угла области необходимо отпустить кнопку 1. При этом выделенная область увеличится до размера области изображения трасс. Если вы начали процесс задания области увеличения (нажали кнопку 1), но потом решили не делать этого, не отпуская кнопку 1, щелкните по кнопке 3 и резиновый прямоугольник исчезнет. Теперь можно безбоязненно отпускать кнопку 1 - ничего не произойдет, изображение останется прежним. Если же вы увеличили область (отпустили кнопку 1) и только потом поняли что ошиблись, для восстановления предыдущего вида воспользуйтесь откаткой.

View -> Zoom out

Действие этого режима во многом противоположно режиму увеличения. Область, задаваемая резиновым прямоугольником, определяет тот объем и его местоположение, до которого сожмется текущая область изображения трасс по окончании операции. Выбор области и отказ от него осуществляется также как и в режиме увеличения.

View -> Info mode

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

#... - номер трассы. Трассы нумеруются внутри программы от единицы начиная с самой верхней загруженной трассы.
HCAB=... - кабельная глубина трассы из слова заголовка HCAB.
COMP='.' - компонента из первого байта слова заголовка COMP. Обычно это одна из букв: X,Y,Z,1,2,3,4.
T=... - время, указанное мышью в милисекундах.
A=... - линейно интерполированная амплитуда в указанной мышью точке.
NMGL=... - логический номер магнитограммы из слова заголовка NMGL.
NTR=... - логический номер канала из слова заголовка NTR.

View -> Manual zoom

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

View -> Zoom all

По данной команде осуществляется прорисовка всего поля трасс во всем диапазоне времен в текущем физическом окне. Иногда, если трасс много, а физическое окно имеет небольшие размеры, полученное в результате изображение имеет нечитаемый вид. Чтобы улучшить картину надо увеличить физическое окно.

View -> Options ...

Вызов диалога задания параметров визуализации трасс.

В этом диалоге можно изменить:

Ширину скользящего окна АРУ в милисекундах (AGC {ms}).
Степень перекрытия соседних трасс (Overlapping). Чем ближе данный параметр к единице, тем визуально больше становятся амплитуды трасс.
Шаг сетки времени в милисекундах (Time grid step).
Вид прорисовки трасс: без зачернения, с зачернением положительных, отрицательных и тех и других амплитуд.

Hodographs -> Determine ...

Вызов диалога определения годографа первого вступления в автоматическом и полувтоматическом режиме. Диалог позволяет задать трассы, по которым будет определяться первое вступление. Во-первых, это могут быть либо трассы глубинного прибора (Depth device), либо контрольного прибора (Control device). Во-вторых, могут быть выбраны трассы компонент 123 или XYZ.

Hodographs -> Shift -> First break hodograph

Пользователь вводит в появившемся диалоговом окне время в мс, на которое надо сдвинуть годограф первого вступления вправо (>0) или влево (<0).

Hodographs -> Shift -> Wave hodograph

Пользователь вводит в появившемся диалоговом окне время в мс, на которое надо сдвинуть волновой годограф вправо (>0) или влево (<0).

Hodographs -> Save -> First break hodograph

Вызывает диалог выбора компоненты с которой будет производиться сохрание годографа первого вступления в базе данных.

По нажатию кнопки OK будет вызван диалог сохранения годографа первого вступления в базе данных.

Hodographs -> Save -> Wave hodograph

Вызывает диалог сохранения волнового годографа в базе данных.

Hodographs -> Load -> First break hodograph

Вызывает диалог загрузки годографа первого вступления из базы данных.

Hodographs -> Load -> Wave hodograph

Вызывает диалог загрузки волнового годографа из базы данных.

Hodographs -> Clear -> First break hodograph

Стирает годограф первого вступления.

Hodographs -> Clear -> Wave hodograph

Стирает волновой годограф.

Hodographs -> Ruler mode

Включает режим работы мышью для задания волнового годографа. Пользователь может ставить и удалять опорные точки ломаной. Отмеченные точки помечаются засечкой красного цвета. Если точек станет больше двух, появится интерполированная в соответствии с глубиной ломаная примерного годографа по всем трассам. Эта линия рисуется зеленым цветом. Точка, поставленная на трассе, стирает предыдущую. Ставить несколько точек на трассах одной кабельной глубины не рекомендуется. При проведении годографа следует учитывать следующие особенности:

Годограф проходит через все узловые точки (красные метки), проставленные мышью.
Если две соседние узловые точки находятся на трассах с разными кабельными глубинами, то участок годографа между ними интерполируется по глубине.
Если последовательный набор трасс одной и той же кабельной глубины имеет одну или ни одной узловой точки, то время годографа на всех трассах набора одинаково (ситуация с многокомпонентными или ненакопленными данными).
Если последовательный набор трасс одной и той же кабельной глубины имеет более одной узловой точки, то годограф между первой и последней узловой точкой набора трасс имеет вид ломаной линии линейно интерполированной между точками.

Точка на трассе устанавливается щелчком 1-й кнопки мыши в предполагаемом месте на трассе. Удалить точку на трассе можно щелкнув 3-й кнопкой мыши на этой трассе.

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

Hodographs -> Hint mode

Включает режим расчета первого вступления с подсказкой. В этом режиме пользователь должен отмечать диапазон времен на трассе нажав 1-ю кнопку мыши в одной крайней точке дипазона, потянув указатель миши и отпустив кнопку в другой крайней точке. Как и в режиме лупы, отменить операцию можно щелкнув по 3-й кнопке мыши не отпуская 1-ю.

Hodographs -> Manual mode

Включает режим директивного задания первого вступления. В этом режиме пользователь должен отмечать диапазон времен на трассе нажав 1-ю кнопку мыши в одной крайней точке дипазона, потянув указатель миши и отпустив кнопку в другой крайней точке. Как и в режиме лупы, отменить операцию можно щелкнув по 3-й кнопке мыши не отпуская 1-ю.

Help -> Context help

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

Help -> User's guide

Вызывает просмотр руководства пользователя.

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

Линейка инструментов располагается под областью визуализации трасс и имеет следующий вид:

Слева от вертикальной черты расположены кнопки действий: при щелчке 1-й кнопкой мыши происходит какое-либо действие, дублирующее соответствующий пункт меню. Правее вертикальной черты расположены кнопки режимов работы мышью на поле трасс. В каждый конкретный момент активен только один из режимов. Кнопка этого режима обведена в таком случае красной рамкой. Изменить текущий режим работы можно щелкнув 1-й кнопкой мыши по пиктограмме соответствующего режима или из меню. Самой правой располагается красная кнопка выхода из программы.

View -> Options ...
View -> Undo
View -> Redo
View -> Zoom all
View -> Info mode
View -> Zoom in
Hodographs -> Ruler mode
Hodographs -> Hint mode
Hodographs -> Manual mode
File -> Exit

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

4.1. Трассы.

Программа загружает одну модификацию трасс, состоящую из двух файлов: таблицы модификации (имя имеет вид Mxxx.tab) и файла данных (имя имеет вид Yxxx.dat), где xxx - три символа уникального кода модификации, обязательно совпадающие в обоих именах , а Y - одна из букв S,R,D, обозначающая вид сортировки ОГТ (данные ВСП как правило имеют сортировку типа S). Модификация должна иметь тип профиля ВСП и тип данных отличный от параметрических, иначе она не будет загружена. Формат файлов трасс и таблицы модификации изложен в документе Глобальные типы данных, определения и форматы файлов.

Программа использует следующие слова заголовков трасс: COMP, HCAB, ACT, NTR, TYPE, NMGL, NMGL, XOPV, YOPV, ZOPV, ZSPV, YSPV, ZSPV. Программа загружает и визуализирует все трассы (даже неактуальные). Но при определении времени первого вступления во всех режимах неактуальные трассы не участвуют.

Подразумевается, что трассы во входной модификации упорядочены по убыванию кабельной глубины (слово HCAB заголовка трасс). Программа визуализирует трассы с конца файла, то есть, от меньших кабельных глубин к большим.

Программа ориентирована на работу с трассами следующих компонент: XYZ или 123. Трассы, имеющие в первом байте слова COMP заголовка трассы иной символ (пусть даже один из xyz), будут рассматриваться как неактуальные. Программа определяет время первого вступления отдельно для глубинного прибора (слово заголовка трассы TYPE равно 0) и контрольного прибора (слово заголовка трассы TYPE равно 1).

4.2. Таблицы БД.

Программа может загружать подготовленные ранее таблицы БД типа FBINFO из списка FBLIST. В зависимости от способа загрузки (годограф первого вступления или волновой годограф) программа будет по-разному интерпретировать содержимое таблиц.

При загрузке таблицы как волнового годографа значения поля TZERO большие нуля будут расцениваться как узловые точки между которыми проводится интерполяция. Прочие строки будут игнорироваться.

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

Отождествление трасс и строк таблицы БД происходит по значению логического номера магнитограммы NMGL, которое является эквивалентом номера взрыва. Поэтому трассы с одинаковым номером NMGL будут сопоставлены первой найденной строке таблицы БД с таким же номером.

4.3. Паспортные данные.

N/A

4.4. Прочие данные.

N/A

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

5.1. Трассы.

N/A

5.2. Таблицы БД.

Программа формирует таблицы БД типа FBINFO и их список типа FBLIST в том случае если он отсутствует. В зависимости от того, что сохраняется в БД (годограф первого вступления или волновой годограф), формирование данных с таблице БД будет происходить по-разному.

При формировании строки в таблице-списке FBLIST поля получат следующие значения:

NVAR - уникальный номер варианта годографа.
COMP - компоненты по которым был определен годограф. Годограф первого вступления сохраняется в таблице БД всегда с какой-либо одной компоненты. Для волнового годографа в данном поле перечисляются все присутствующие в файле компоненты.
COMMENT - комментарий с типом годографа: "Wave hodograph" или "FB hodograph".
NMOD - номер модификации по которой был определен годограф.
DTBSPTR - имя таблицы данных, содержащей годограф.

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

NMGL - логический номер магнитограммы.
NTR - логический номер канала.
HCAB - кабельная глубина.
XOP - X-координата точки приема.
YOP - Y-координата точки приема.
ZOP - Z-координата точки приема.
XSP - X-координата точки взрыва.
YSP - Y-координата точки взрыва.
ZSP - Z-координата точки взрыва.
TFB - время первого вступления (милисекунды).
TSLOPE - время на левом склоне (милисекунды). Смотри график.
TZERO - время пересечения нуля правым склона (милисекунды). Смотри график.
TFBMX - время фазы (милисекунды). Смотри график.
AFBMX - амплитуда фазы. Смотри график.
AGLMX - амплитуда глобального экстремума (абсолютное значение). Смотри график.
SNRATIO - отношение сигнал/шум по промежутку от начала трассы до TFB.
ANOISE - оценка амплитуды шума по промежутку от начала трассы до TFB.
AMEAN - оценка смещения нуля по промежутку от начала трассы до TFB.
Остальные поля таблицы неинициализированы.

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

NMGL - логический номер магнитограммы.
NTR - логический номер канала.
HCAB - кабельная глубина.
XOP - X-координата точки приема.
YOP - Y-координата точки приема.
ZOP - Z-координата точки приема.
XSP - X-координата точки взрыва.
YSP - Y-координата точки взрыва.
ZSP - Z-координата точки взрыва.
TFB - интерполированное время годографа (милисекунды).
TZERO - положительное число обозначает узловая точка волнового годографа (милисекунды). Отрицательное число обозначает что для данной трассы (группы трасс) годограф должен интерполироваться по двум ближайшим узловым точкам.
Остальные поля таблицы неинициализированы.

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

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

5.3. Паспортные данные.

N/A

5.4. Отчетные данные.

N/A

5.5. Прочие данные.

N/A

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

Поддерживаемые платформы:

Рабочие станции семейства IBM RS/6000 с ОС AIX 3.2.5.
Рабочие станции семейства SUN SPARCstation с ОС Solaris 2.3, 2.4.

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

Для работы с программой необходимо определить переменную среды VSPHOME. Местом ее определения может быть файл setup или стартовый профиль пользователя. В файле setup определение этой переменной должно выглядеть, например, так (пробелы в строке не допускаются!):

VSPHOME=/home/vsp

где /home/vsp - корневой каталог пакета ВСП. При инсталляции пакета корневой каталог может быть задан другим путем.

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

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

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

N/A

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

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

При старте программа проверяет наличие файлов setup, .sdscolor и в случае их отсутствия выводит на терминал соответствующее сообщение. После того как программа стартовала все сообщения выводятся в информационную строку под панелью инструментов. Исключение составляют сообщения выводимые в случае ошибок в процессе определения первого вступления. Они попадают в стандартный поток ошибок, обычно соответствующий терминалу с которого запущена программа или меню системы ВСП (если программа запущена из меню).

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

Сообщения, выводимые в информационную строку:

"%d lines in `%s' were saved successfully": Информация для пользователя о количестве строк в сохраненной таблице БД с годографом первого вступления.
"%d traces in `%s' were not matched": Сообщает пользователю, что при загрузке указанной таблицы БД не удалось сопоставить указанное количество трасс со строками БД. Это говорит о том, что таблица была получена по существенно другому файлу трасс. Сопоставление происходит по значению логического номера магнитограммы NMGL. Смотри также требования к входным таблицам БД.
"CreateVTS: Internal error": Внутренняя ошибка вызванная невозможностью создания открытия входного файла.
"CreateVTS: Memory allocation fault": Внутренняя ошибка.
"Error of writing in data base `%s'": Невозможность записать изменения в указанную таблицу БД.
"FEAllocMemBlock: Memory allocation fault": Внутренняя ошибка при выделении блока памяти.
"Graphics error": Внутренняя ошибка при попытке создать графический контекст.
"HCAB=%g: TFB=%g, SNRATIO=%g, AMEAN=%g": Выводится для каждой трассы в процессе определения первого вступления.
"HCAB: %g .. %g m; NMGL: %d .. %d": Сообщение выводится в процессе прокручивания поля визуализации по шкале глубины пока пользователь не отпустил 1-ю кнопку мыши. Сообщение содержит информацию о текущем диапазоне кабельных глубин и логических номеров магнитограмм трасс. Если пользователь отпускает 1-ю кнопку мыши, в поле визуализации изображаются трассы указанного диапазона. Данную возможность удобно использовать при поиске нужного интервала визуализации.
"Hint first entrance mode": Сигнализирует о включении режима определения первого вступления с подсказкой.
"Indexes or/and times toggle button must be pressed ": В диалоге ручного задания пределов визуализации следует выбрать одну или обе строки с введенными значениями.
"Interactive program does not have valid parameters": Сообщение сигнализирует о том, что программа была запущена не из под графа обработки СЦС-5.
"LinkGEtoVTS: Graphics error": Внутренняя ошибка при попытке инициализировать графический интерфейс.
"MarkInit: Internal error": Внутренняя ошибка.
"MarkInit: Memory allocation fault": Внутренняя ошибка связанная с нулевым количеством трасс во входном файле.
"Memory allocation fault": Внутренняя ошибка при выделении блока памяти.
"Manual first entrance mode": Сигнализирует о включении режима директивоного задания первого вступления.
"No changes available for redo": Сообщает пользователю о том что дальнейшая отмена откатки невозможна в силу исчерпания оной.
"No changes available for undo": Сообщает пользователю что дальнейшая откатка невозможна - визуализатор находится в исходном состоянии.
"No trace at this point": Выводится в режиме получения информации о трассе в том случае если программа не может отождествить указанную пользователем точку на поле трасс ни с какой трассой.
"OpenTraceSet: File is not found": Файл трасс или таблицы модификации не найден.
"OpenTraceSet: File reading error": Ошибка при чтении файла трасс или таблицы модификации. Вероятно, один из этих файлов имеет неправильный формат.
"OpenTraceSet: Internal error": Внутренняя ошибка при открытии файла трасс.
"OpenTraceSet: Memory allocation fault": Внутренняя ошибка при выделении блока памяти.
"OpenTraceSet: Not a VSP data (check line type in mod. table)": Тип профиля (поле LTYPE таблицы модификации) не ВСП (код 4).
"Possible bad format of `%s'": Неправильный формат файла таблицы БД.
"Possible bad format of `%s'; check file&dir permissions also"
"Possible bad format of `%s'; check permissions also": Неправильный формат файла таблицы БД или невозможно создать/получить доступ к файлу таблицы БД. Следует проверить привилегии доступа пользователя к каталогу данных проекта и файлу БД по чтению и записи.
"Process completed successfully for %d (of %d) traces": Информирует пользователя о завершившемся процессе автоматического определения первого вступления. Первая цифра показывает число трасс, участвовавших в определении первого вступления. Вторая цифра является обшим числом трасс в загруженном файле трасс. Эти цифры могут не совпадать по причине того, что не все трассы актуальные. Некоторые из них записаны другим типом прибора или являются компонентой, не принимающей участие в обработке (см. также диалог определения годографа первого вступления).
"Processing ...": Сигнализирует о начавшемся процессе автоматического определения первого вступления.
"Project=%s, Modification=%s": Информирует пользователя о только что загруженной модификации и рабочем проекте.
"Redo step": Сигнализирует о совершенном шаге отмены откатки.
"Ruler mode": Сигнал о включении режима линейки для задания волнового годографа.
"The proper index range from 1 to %u": Ошибка пользователя при задании номеров визуализируемых трасс. Номера трасс принадлежат указанному диапазону.
"The proper time range from %f to %f": Ошибка пользователя при задании временного интервала визуализации. Времена должны принадлежать указанному диапазону в милисекундах.
"Times: %g .. %g ms": Сообщение выводится в процессе прокручивания поля визуализации по шкале времен пока пользователь не отпустил 1-ю кнопку мыши. Сообщение содержит информацию о текущем диапазоне времен в милисекундах. Если пользователь отпускает 1-ю кнопку мыши, в поле визуализации изображаются трассы в указанном диапазоне времен. Данную возможность удобно использовать при поиске нужного интервала визуализации.
"Trace information mode": Сигнал о включении режима получения информации о трассе.
"Trace reading error": Внутренняя ошибка при попытке получить информацию о трассе.
"Unexpected allocation fault": Внутренняя ошибка связанная с неудачей получения блока памяти в процессе сохранения волнового годографа в таблице БД.
"Unexpected error of the first entrance analisys": Внутренняя ошибка в процессе подготовки в определению годографа первого вступления.
"Undo step": Сигнализирует о совершенном шаге откатки.
"User interruption": Сигнализирует о том что процесс автоматического определения первого вступления был прерван пользователем.
"Zoom-in mode": Сигнал о включении режима увеличивающей лупы.
"Zoom-out mode": Сигнал о включении режима уменьшающей лупы.
"`%s': check file & dir permissions": Невозможно сохранить указанную таблицу БД в файле. Надо проверить доступность каталога данных проекта на возможность записи в него.
"`%s' was loaded successfully": Информация об успешной загрузке таблицы БД с волновым годографом.
"`%s' was saved successfully": Информация об успешном сохранении таблицы БД с волновым годографом.

Сообщения, выводимые в поток ошибок (обычно, на терминал):

"FATAL: Can not open 'setup' in HOME directory.": Файл setup не найден в домашнем каталоге пользователя.
"FATAL: Can not open '.sdscolor' in HOME directory.": Файл .sdscolor не найден в домашнем каталоге пользователя.
"FATAL: VSPHOME is undefined."
"FATAL: VSPHOME is empty.": Переменная окружения VSPHOME, которая должна быть объявлена в файле setup или профиле пользователя, отсутствует или ее значение отсутствует.
"ERROR: Can not create user configuration directory."
"ERROR: Can not use user configuration directory.": Каталог пользовательских настроек .vsp в домашнем каталоге пользователя не удалось создать или получить к нему доступ. Данные ошибки не приводят к потере работоспособности программы.
"HCAB=%g: DFAP error #%d": Внутренняя ошибка с указанным номером возникшая в процессе определения первого вступления на указанной кабельной глубине.
"HCAB=%g: Zero trace!": Нулевая трасса или интервал для поиска первого вступления на указанной кабельной глубине слишком мал.
"HCAB=%g: No right inflection!": Полупериод предполагаемого первого вступления на указанной кабельной глубине своим правым склоном не пересекает ноль.
"HCAB=%g: Rude internal error!": Серьезная внутренняя ошибка при определении первого вступления на указанной кабельной глубине.

8. Пример использования.

Смотри описание сеанса работы для указанных ниже тестовых данных.

Тестовые данные:

DATA/S003.dat DATA/M003.tab: Модификация, содержащая трехкомпонентные (XYZ) трассы с кратностью больше 1. Глубины: 2465..2525 с шагом 15 метров. Время записи: 0..5000 милисекунд. Шаг дискретизации: 1 мс. Скважина с именем english.
DATA/VSP.english..FBINFO.1: Таблица базы данных, содержащая полученный годограф первых вступлений. Годограф сохранен с компоненты Z.
DATA/VSP.english..FBINFO.2: Таблица базы данных, содержащая полученный априорный годограф.

Юниверс

Процедуры пакета ЮНИВЕРС

Kinematic processing: