mgd77managegmt - Интернет в облаке

ПРОГРАММА:

ИМЯ

mgd77manage - Управление содержимым файлов MGD77 +

СИНТАКСИС

мгд77управление NGDC-идентификаторы [[+]a|c|d|D|e|E|g|i|n|t|TFileInfo ] [ f|g|e ] [ сокращение1,сокращение2, ...)
] [ пустой ] [] [ сокращение/имя/Ед. изм/t/лестница/смещение/комментарий ] [ Ед. изм ] [ область ] [[уровень]
] [ -би] [ -du] [ -n]

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

ОПИСАНИЕ

мгд77управление занимается поддержкой дополнительных настраиваемых столбцов в файлах MGD77 + netCDF. Ты сможешь
удалите один или несколько столбцов, добавьте новый столбец, обновите существующий столбец новым
данных или предоставьте информацию для исправления ошибок (файлы * .e77). Новые данные могут поступать из таблицы
(ASCII, если -би используется), основываться на существующих столбцах и определенных теоретических
выражений, или они могут быть получены путем выборки сетки (выберите между сеткой GMT или
Sandwell / Smith Mercator * .img grid) вдоль трассы. Новые данные будут добавлены в
MGD77 + в виде дополнительного столбца данных указанного типа. Файл данных будет
модифицированный; новый файл не будет создан. По важным вопросам см. Раздел ОБСУЖДЕНИЕ.
внизу.

ТРЕБУЕТСЯ АРГУМЕНТЫ

NGDC-идентификаторы
Может быть одним или несколькими из пяти видов спецификаторов:

1. 8-значные идентификаторы NGDC, например 01010083, JA010010 и т. Д.

2. 2-символьный коды, которые вернут все круизы от каждого агентства.

3. 4 символа коды, которые вернут все круизы из тех
судов.

4. = , куда представляет собой таблицу с идентификаторами NGDC, по одному в каждой строке.

5. Если ничего не указано, мы возвращаем все круизы в базу данных.

(См. Mgd77info -L для кодов агентств и судов). Расширения ".mgd77" или ".nc"
будет автоматически добавлен при необходимости (используйте -I игнорировать определенные типы файлов).
Файлы круиза будут искать сначала в текущем каталоге, а потом - во всех
каталоги, перечисленные в $ MGD77_HOME/mgd77_paths.txt [Если $ MGD77_HOME не установлен
по умолчанию будет $ GMT_SHAREDIR/ mgd77].

ДОПОЛНИТЕЛЬНО АРГУМЕНТЫ

-A [+] a | c | d | D | e | E | g | i | n | t | TFileInfo
Добавьте новый столбец данных. Если существующий столбец с таким же сокращением уже
существует в файле, мы трусливо откажемся обновлять файл. Указание -A +
преодолевает это сопротивление (однако иногда существующий столбец не может быть обновлен
без предварительного удаления; если да, то вас предупредят). Выберите исходный код столбца
среди a, c, d, D, e, g, i, n, tили T; подробные описания для каждого варианта
следующим образом:

a Добавить имя файла таблицы с одним столбцом для добавления. Файл должен иметь тот же номер
строк как файл MGD77 +. Если файл не указан, мы вместо этого читаем из stdin.

c Создайте новый столбец, основанный на существующих данных или формулах для исправлений.
и справочные поля. Добавить c для поправок Картера, вычтенных из
нескорректированные глубины, g для опорного гравитационного поля IGF (также известного как «нормальная гравитация»),
m для опорного магнитного поля полного поля IGRF, и r для пересчитанного магнитного
аномалия (добавьте 1 или 2, чтобы указать, какой столбец общего поля использовать [1]). Для гравитации
мы выбираем опорное поле на основе параметра Теоретическая формула гравитации
Код в заголовке круиза MGD77. Если он не установлен или недействителен, по умолчанию используется
IGF 1980. Вы можете изменить это поведение, добавив желаемый код: 1 =
Heiskanen 1924, 2 = International 1930, 3 = IGF1967 или 4 = IGF1980.

d Добавить имя файла двухколоночной таблицы с указанием расстояний в первом столбце
вдоль дорожки, а второй столбец содержит значения данных. Если файл не указан, мы читаем
вместо стандартного ввода. Записи с совпадающими расстояниями в файле MGD77 + будут
присвоили новые значения; на других расстояниях мы устанавливаем их в NaN. В качестве альтернативы дайте
верхний регистр D вместо этого мы будем интерполировать столбец на всех расстояниях записи.
Читать -N для выбора единиц измерения расстояния и -C для выбора расстояний
рассчитывается.

e Ожидает найти журнал ошибок / исправлений e77 от мгд77сниффер с именем
NGDC_ID.e77 в текущем каталоге или в $ MGD77_HOME / E77; этот файл будет проверен
и используется для внесения изменений в значения заголовков, задает систематический
исправление для определенных столбцов (таких как масштаб и смещение), укажите, что определенный
аномалия должна быть пересчитана из наблюдений (например, пересчитать mag из
mtf1 и последний IGRF), а также добавить или обновить специальный столбец флажок который может содержать
битовые флаги (0 = ХОРОШО, 1 = ПЛОХО) для каждого поля данных в стандартном наборе данных MGD77.
Обнаружены любые фиксированные поправочные условия (например, необходимость масштабирования поля на 0.1 или 10).
поскольку исходное агентство использовало неправильные единицы измерения) будут записаны как атрибуты для
файл netCDF MGD77 + и применяется, когда данные считываются мгд77лист. Эфемерный
поправки, такие как те, которые определены с помощью перекрестного анализа, не сохраняются в данных
файлы, но находятся в таблицах исправлений (см. мгд77лист подробнее). По умолчанию
первый символ каждой строки заголовка в файле e77 (?, Y или N) будет
проконсультировались, чтобы увидеть, следует ли применять соответствующую регулировку. Если есть
обнаружены нерешенные настройки (ii,?), мы прервем работу и не внесем никаких изменений. Только
записи с пометкой Y будут обработаны. Вы можете изменить это поведение, добавив один
или более модификаторов к -Ае команда: h игнорирует все исправления заголовка, f будете
игнорировать все фиксированные систематические корректировки тренда, n, vкачества s будет игнорировать битовые флаги
относящиеся к навигации, значениям данных и наклонам данных соответственно. Использовать -А + е в
замените все существующие исправления E77 в файле новыми значениями. Наконец, e77
исправления не будут применяться, если файл E77 не был проверен. Использовать -АЭ в
игнорировать статус проверки.

g Пример географической сетки по Гринвичу (долгота, широта) вдоль трека, заданного файлом MGD77 +
используя бикубическую интерполяцию (однако см. -n). Добавить имя файла сетки GMT.

i Пример сетки Sandwell / Smith Mercator * .img вдоль трека, заданного MGD77 +
файл с использованием бикубической интерполяции (однако см. -n). Добавьте имя файла сетки img,
за которым следует шкала данных, разделенных запятыми (обычно 1 или 0.1), режим файла IMG
(0–3) и, необязательно, максимальная широта сетки img [80.738]. Режимы означают
следующее: (0) Img файлы без кода ограничения, возвращает данные во всех точках, (1)
Img файл с закодированными ограничениями, возвращает данные во всех точках, (2) Img файл с
закодированные ограничения, возвращать данные только в ограниченных точках и NaN в другом месте, и
(3) Файл Img с закодированными ограничениями, возвращает 1 в ограничениях и 0 в других местах.

n Добавить имя файла таблицы с двумя столбцами с первым столбцом, содержащим запись
число (от 0 до строк - 1), а второй столбец содержит значения данных. Если нет файла
учитывая, что вместо этого мы читаем из stdin. Записи с совпадающими номерами записей в
Файлу MGD77 + будут присвоены новые значения; для других рекордов мы устанавливаем их в NaN.

t Добавить имя файла таблицы с двумя столбцами, указав в первом столбце абсолютное значение
раз по дорожке, а второй столбец содержит значения данных. Если файл не указан, мы
вместо этого читать из стандартного ввода. Записи с совпадающим временем в файле MGD77 + будут
присвоили новые значения; в других случаях мы устанавливаем их на NaN. В качестве альтернативы дайте
верхний регистр T вместо этого мы будем интерполировать столбец в любое время записи.

-Cf | g | e
Добавьте однобуквенный код, чтобы выбрать процедуру определения путевого расстояния.
расчет при использовании -Объявление|D (См. -N для выбора единиц расстояния):

f Расстояния плоской Земли.

g Расстояния по большому кругу [по умолчанию].

e Геодезические расстояния на текущем эллипсоиде GMT.

-Dсокращение1,сокращение2, ...)
Дайте разделенный запятыми список сокращений столбцов, из которых вы хотите удалить
файлы MGD77 +. НЕ используйте эту опцию для удаления заменяемых столбцов.
с новыми данными (используйте -A + вместо). Потому что мы не можем удалить переменные из netCDF
files, мы должны создать новый файл без удаляемых столбцов. Как только файл
успешно создан, мы временно переименовываем старый файл, меняем новое имя файла на
старое имя файла и, наконец, удалите старый переименованный файл.

-Eпустой
Задайте один символ, который будет повторяться для заполнения пустых строковых значений, например,
«9» даст строку типа «99999 ...» [9].

-F Принудительный режим. Когда этот режим активен, вы можете удалить или заменить даже
стандартный набор колонок МГД77. Тебе лучше знать, что ты делаешь!

-Iсокращение/имя/Ед. изм/ Т /лестница/смещение/комментарий
Помимо информации о файле, мы должны указать дополнительную информацию о
дополнительный столбец. Укажите короткий (не более 16 знаков, строчные буквы, цифры,
или только подчеркивание) аббревиатура выбранных данных, их более информативное имя,
блок данных, тип данных 1-символьный код (bайт, sхорт fлох iнт, dдвойной, или
text), который вы хотите использовать для хранения в файле netCDF, любой масштаб и смещение мы должны
применить к данным, чтобы они соответствовали диапазону, предполагаемому выбранным хранилищем
тип и общий комментарий (<128 символов) относительно того, что представляют собой эти данные.
Примечание. Если выбран текстовый тип данных, тогда термины «значения» в -A обсуждение
обратитесь к вашим текстовым данным. Кроме того, обсуждение интерполяции не
применить, и значение NaN станет значением "без строки" (см. -E для чего это).
Заключите в кавычки термины, содержащие более одного слова (например, «Скорректированная глубина»).

-NЕд. изм Добавьте единицы измерения расстояния (см. ЕДИНИЦЫ). [По умолчанию -Нк (км)]. Актуально только тогда, когда
-Аг|i .

-Р[Ед. изм]хмин/Xmax/юмин/умакс[р] (Больше ...)
Укажите интересующий регион. Актуально только тогда, когда -Аг|i .

-V [уровень] (Больше ...)
Выберите уровень детализации [c].

-bi [нколс] [т] (Больше ...)
Выберите собственный двоичный вход. Это относится к входным файлам данных с 1 или 2 столбцами.
указано в некоторых -A опции. Опция двоичного входа доступна только
для столбцов с числовыми данными.

-duнет данных (Больше ...)
Заменить входные столбцы, равные нет данных с NaN.

-n [b | c | l | n] [+ a] [+ bBC] [+ c] [+ tпорог] (Больше ...)
Выберите режим интерполяции для сеток.

-^ or всего -
Распечатайте короткое сообщение о синтаксисе команды, затем закройте (ПРИМЕЧАНИЕ: в Windows
использовать просто -).

-+ or всего +
Распечатайте подробное сообщение об использовании (справке), включая объяснение любых
параметр, зависящий от модуля (но не общие параметры GMT), затем закрывается.

-? or нет Аргументы
Распечатайте полное сообщение об использовании (справке), включая объяснение опций, затем
выходы.

--версия
Распечатайте версию GMT и выйдите.

--show-datadir
Вывести полный путь к общему каталогу GMT и выйти.

ЕДИНИЦЫ

Для единицы расстояния на карте добавьте Ед. изм d для степени дуги, m за угловую минуту, и s для дуги
второй, или e для счетчика [По умолчанию], f для стопы, k за км, M за статутную милю, n для морских
миля, и u для американской съемки стопы. По умолчанию мы вычисляем такие расстояния, используя сферический
приближение с большими кружками. Подготовить - на расстояние (или единица измерения
дано), чтобы выполнить расчеты "Плоской Земли" (быстрее, но менее точно) или добавить + в
выполнять точные геодезические расчеты (медленнее, но точнее).

ПОСЛЕДСТВИЯ OF GRID ПЕРЕЗАГРУЗКА

Передискретизация или выборка сеток будут использовать различные алгоритмы (см. -n), что может привести к
возможные искажения или неожиданные результаты в повторно дискретизированных значениях. Один ожидаемый эффект
повторной выборки со сплайнами - это тенденция к тому, что новые значения повторной выборки немного превышают
глобальные минимальные / максимальные пределы исходной сетки. Если это недопустимо, можно наложить
отсечение значений передискретизированных значений, чтобы они не превышали входные минимальные / максимальные значения на
добавить +c . -n опцию.

ПРИМЕРЫ

Чтобы добавить Geosat / ERS-1 Gravity версии 11.2 в качестве дополнительного столбца данных в круизах
01010047.nc и 01010008.nc, сохраняя значения как mGal * 10 в 2-байтовом коротком целом числе, попробуйте

gmt mgd77manage 01010047 01010008 -Ai10 / 1 / grav.11.2.img \
-Isatgrav / "Geosat / ERS-1 gravity" / "mGal" / s / 10/0 / "Sandwell / Smith version 11.2" -V

Чтобы добавить отфильтрованную версию магнетизма в качестве дополнительного столбца данных типа float для
круиз 01010047.nc и интерполировать отфильтрованные данные во время, указанное в MGD77 +
файл, попробуйте

gmt mgd77manage 01010047 -ATmymag.tm -Ifiltmag / "Промежуточная длина волны \
магнитные остатки »/« nTesla »/ f / 1/0 /« Полезно для поиска изохронов »-V

Чтобы удалить существующие дополнительные столбцы satfaa, coastdist и satvgg из всех файлов MGD77 +,
стараться

gmt mgd77manage = allmgd77.lis -Dsatfaa, coastdist, satvgg -V

Чтобы создать 4-байтовый столбец с плавающей запятой с правильным полем ссылки IGRF во всех файлах MGD77 +,
стараться

gmt mgd77manage = allmgd77.lis -Acm -Iigrf / "Ссылка на IGRF \
поле "/" нТесла "/ ф / 1/0 /" ИГРФ версия 10 на 1990-2010 гг. "-В

ОБСУЖДЕНИЕ

1. преамбула

Добавка mgd77 - это попытка (1) улучшить ограниченную функциональность
существующее дополнение mgg, (2) включает некоторые идеи из дополнения Scripps gmt +
добавляя дополнительные столбцы данных, и (3) добавляя новые возможности для управления морскими
геофизические данные трассы хранятся в независимой от архитектуры CF-1.0- и
COARDS-совместимый формат файлов netCDF. Вот некоторые из основных идей и шагов, которые вы
нужно принять для поддержания ваших файлов.

2. Введение

Наша отправная точка - файлы данных MGD77 ASCII, распространяемые из NGDC на компакт-дисках,
DVD-диски, и через FTP. Используя Geodas для локальной установки файлов, мы выбираем "Carter
скорректированная глубина », которая заполнит столбец глубины, используя время двухстороннего пробега
и таблицы Картера, если присутствует twt. Этот шаг дает ~ 5000 отдельных файлов круиза.
Поместите их в один или несколько подкаталогов по вашему выбору, перечислите эти подкаталоги (один
на строку) в файле mgd77_paths.txt и поместите этот файл в каталог, на который указывает
$ MGD77_HOME; если не установить эту переменную по умолчанию $ GMT_SHAREDIR/ mgd77.

3. Конверсия

Преобразуйте файлы ASCII MGD77 в новый формат netCDF MGD77 +, используя mgd77конвертировать.
Как правило, вы составляете список всех круизов, которые нужно преобразовать (с или без
extension), а затем запустите
mgd77convert = cruises.lis -Fa -Tc -V -Lwe +> log.txt

Подробные настройки гарантируют, что все проблемы, обнаруженные во время конвертации, будут
сообщил. Новые файлы * .nc также могут быть помещены в один или несколько отдельных подкаталогов.
и они также должны быть перечислены в файле mgd77_paths.txt. Предлагаем вам разместить
каталоги с файлами * .nc перед каталогами * .mgd77. Когда вы позже захотите ограничить
поиск по файлам определенного расширения следует использовать -I опцию.

4. Добавление new столбцы

мгд77управление позволит вам добавлять дополнительные столбцы данных в ваши файлы * .nc. Это может быть
что угодно, включая текстовые строки, но, скорее всего, это числовые значения, выбранные вдоль
отслеживать из предоставленной сетки или существующего столбца, который был отфильтрован или изменен
для определенной цели. Формат поддерживает до 32 таких дополнительных столбцов. Посмотри на этого человека
страницу о том, как добавлять столбцы. Позже вы можете решить удалить некоторые из этих столбцов или
обновить данные, связанные с определенным столбцом. Инструменты извлечения данных, такие как мгд77лист
может использоваться для извлечения комбинации стандартных столбцов MGD77 (навигация, время и обычные столбцы).
геофизические наблюдения) и ваши настраиваемые столбцы.

5. Ошибка источников

Прежде чем обсуждать, как исправить ошибки, мы сначала перечислим различные классы ошибок.
связанные с данными MGD77: (1) ошибки записи заголовка возникают, когда некоторая информация
поля в заголовке не соответствуют спецификации MGD77 или необходимая информация
пропавшими без вести. mgd77конвертировать будет перечислять эти ошибки, если расширенный подробный параметр установлен
выбрано. Эти ошибки обычно не влияют на данные, а являются ошибками в
мета-данные (2). Исправлены систематические ошибки, возникающие, когда конкретный столбец данных, несмотря на
Спецификация MGD77 была закодирована неправильно. Обычно это означает, что данные будут отключены
на постоянный коэффициент, такой как 10 или 0.1, или в некоторых случаях даже 1.8288, что преобразует
сажени в метры. (3) Неизвестные систематические ошибки возникают, когда прибор, записавший
данные или обработка, которая последовала за введенными сигналами, которые кажутся систематическими
функции времени вдоль пути, широты, курса или другой комбинации терминов, которые
иметь физическое или логическое объяснение. Эти условия могут иногда быть разрешены данными
методы анализа, такие как попутные и попутные расследования, и приведут к
в терминах коррекции, которые при применении к данным удаляют эти нежелательные сигналы в
оптимальный способ. Поскольку эти условия исправления могут измениться при рассмотрении новых данных в
По их определению, такие исправления считаются недолговечными. (4) Индивидуальные данные
точки или последовательности данных могут нарушать правила, например выходить за пределы возможных диапазонов или
другими способами нарушают здравомыслие. Кроме того, последовательности точек, которые могут находиться в допустимых пределах
диапазоны могут привести к необоснованным градиентам данных. Статус каждой точки
поэтому может быть определен, и это приводит к появлению битовых флагов ХОРОШО или ПЛОХО. Наша политика
что источники ошибок 1, 2 и 4 будут исправлены путем предоставления информации в виде метаданных
в соответствующих файлах * .nc, тогда как исправления для источника ошибки 3 (потому что они будут
постоянно совершенствоваться) будет сохраняться в отдельном списке исправлений.

6. Обнаружение Ошибки

Ассоциация мгд77сниффер это инструмент, который выполняет тщательную постоянную проверку работоспособности оригинального
MGD77 файлы ASCII и создает соответствующий журнал ошибок * .e77. Все найденные проблемы
кодируется в журнале ошибок, и при необходимости приводятся рекомендуемые фиксированные сроки исправления. An
аналитик может проверить, действительно ли предложенные исправления действительны (мы только хотим
исправьте действительно очевидные ошибки устройства), отредактируйте эти журналы ошибок и измените условия исправления
и активируйте их, изменив соответствующий кодовый ключ (см. мгд77сниффер Больше подробностей).
мгд77управление может принимать эти журналы ошибок и (1) исправлять плохие записи заголовков с учетом
предложения в журнале, (2) вставить термины поправки масштаба / смещения, которые будут использоваться при чтении
определенные столбцы и (3) вставьте найденные битовые флаги. Повторите этот шаг, если позже обнаружите
другие проблемы, так как все настройки или флаги E77 будут воссозданы на основе последнего журнала E77.

7. Ошибка корректировки

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

CREDITS

Расчеты IGRF основаны на программе Fortran, написанной Сьюзан Макмиллан из Великобритании.
Геологическая служба, переведенная на C через f2c Хоакимом Луисом и адаптированная к стилю GMT от
Поль Вессель.

Используйте mgd77managegmt в Интернете с помощью сервисов onworks.net