mgd77managegmt: en línea en la nube

PROGRAMA:

NOMBRE

mgd77manage: gestiona el contenido de los archivos MGD77 +

SINOPSIS

mgd77gestionar ID de NGDC [[+]a|c|d|D|e|E|g|i|n|t|Tfileinfo ] [ f|g|e ] [ abrev1,abrev2, ...)
] [ vacío ] [] [ abrev/nombre /unidad/t/escala/compensar/comentario ] [ unidad ] [ región ] [[nivel]
] [ -bi] [ -du] [ -n]

Nota: No se permite ningún espacio entre el indicador de opción y los argumentos asociados.

DESCRIPCIÓN

mgd77gestionar se ocupa del mantenimiento de columnas personalizadas adicionales en archivos MGD77 + netCDF. Usted puede
eliminar una o más columnas, agregar una nueva columna, actualizar una columna existente con una nueva
o proporcione información de corrección de errores (archivos * .e77). Los nuevos datos pueden provenir de una tabla
(ASCII a menos que -bi se utiliza), basarse en columnas existentes y ciertas
expresiones, o pueden obtenerse muestreando una cuadrícula (elija entre cuadrícula GMT o una
Sandwell / Smith Mercator * .img grid) a lo largo de la vía. Los nuevos datos se agregarán al
Archivo MGD77 + en forma de columna de datos adicionales del tipo especificado. El archivo de datos será
modificado; no se creará ningún archivo nuevo. Para los grandes problemas, consulte la sección DISCUSIÓN
abajo.

REQUERIDO ARGUMENTOS

ID de NGDC
Puede ser uno o más de cinco tipos de especificadores:

1. ID de NGDC de 8 caracteres, por ejemplo, 01010083, JA010010etc., Etc.

2. 2 caracteres códigos que devolverán todos los cruceros de cada agencia.

3. 4 caracteres códigos, que devolverán todos los cruceros de aquellos
vasos

4. = , dónde es una tabla con ID de NGDC, uno por línea.

5. Si no se especifica nada, devolvemos todos los cruceros en la base de datos.

(Ver mgd77info -L para códigos de agencia y embarcación). Las extensiones ".mgd77" o ".nc"
se agregará automáticamente, si es necesario (use -I para ignorar ciertos tipos de archivos).
Los archivos de crucero se buscarán primero en el directorio actual y en segundo lugar en todos
directorios listados en $ MGD77_HOME/mgd77_paths.txt [Si $ MGD77_HOME no está configurado
por defecto a $ GMT_SHAREDIR/ mgd77].

OPCIONAL ARGUMENTOS

-A [+] a | c | d | D | e | E | g | i | n | t | Tfileinfo
Agregue una nueva columna de datos. Si una columna existente con la misma abreviatura ya
existe en el archivo, cobardemente nos negaremos a actualizar el archivo. Especificando -A +
supera esta reticencia (sin embargo, a veces una columna existente no se puede actualizar
sin borrarlo primero; si es así, se le advertirá). Seleccione un código fuente de columna
entre a, c, d, D, e, g, i, n, to T; descripciones detalladas para cada elección
siguen:

a Agregue el nombre de archivo de una tabla de una sola columna para agregar. El archivo debe tener el mismo número
de filas como el archivo MGD77 +. Si no se proporciona ningún archivo, leemos desde stdin en su lugar.

c Cree una nueva columna que se derive de datos o fórmulas existentes para realizar correcciones.
y campos de referencia. Adjuntar c para las correcciones de Carter restadas de
profundidades sin corregir, g para el campo de referencia de gravedad IGF (también conocido como "gravedad normal"),
m para el campo de referencia magnético de campo total IGRF, y r para magnéticos recalculados
anomalía (agregue 1 o 2 para especificar qué columna de campo total usar [1]). Por gravedad
Elegimos el campo de referencia basándonos en el parámetro Fórmula teórica de gravedad
Código en el encabezado MGD77 del crucero. Si esto no está configurado o no es válido, de forma predeterminada
el IGF 1980. Puede anular este comportamiento agregando el código deseado: 1 =
Heiskanen 1924, 2 = Internacional 1930, 3 = IGF1967 o 4 = IGF1980.

d Agregue el nombre de archivo de una tabla de dos columnas con la primera columna que mantiene distancias
a lo largo de la pista y la segunda columna contiene valores de datos. Si no se da ningún archivo, leemos
de stdin en su lugar. Los registros con distancias coincidentes en el archivo MGD77 + serán
asignó los nuevos valores; en otras distancias, los configuramos en NaN. Alternativamente, da
mayúscula D en su lugar, interpolaremos la columna en todas las distancias de registro.
See -N para elegir unidades de distancia y -C para elegir como son las distancias
calculado.

e Espera encontrar un registro de errores / correcciones e77 de mgd77sniffer con el nombre
NGDC_ID.e77 en el directorio actual o en $ MGD77_HOME / E77; este archivo será examinado
y se utiliza para realizar modificaciones en los valores del encabezado, especificar un sistema
corrección para ciertas columnas (como la escala y el desplazamiento), especifique que un cierto
La anomalía debe recalcularse a partir de las observaciones (por ejemplo, recalcular la magnitud de
mtf1 y el IGRF más reciente) y agregue o actualice la columna especial bandera que puede contener
bitflags (0 = BUENO, 1 = MALO) para cada campo de datos en el conjunto de datos estándar MGD77.
Cualquier término de corrección fijo encontrado (como la necesidad de escalar un campo en 0.1 o 10
porque la agencia de origen utilizó unidades incorrectas) se escribirán como atributos para
el archivo netCDF MGD77 + y se aplica cuando los datos son leídos por Lista mgd77. Efímero
las correcciones como las determinadas por el análisis cruzado no se guardan en los datos
archivos pero residen en tablas de corrección (ver Lista mgd77 para detalles). Por defecto, el
El primer carácter de cada línea de encabezado en el archivo e77 (que es?, Y o N) será
consultado para ver si se debe aplicar el ajuste correspondiente. Si alguna
Se encuentran configuraciones indecisas (ii,?) abortaremos y no haremos cambios. Solamente
Los registros marcados con Y serán procesados. Puede anular este comportamiento agregando uno
o más modificadores a la -ae mando: h ignorará todas las correcciones de encabezado, f seguirá
ignorar todas las correcciones de tendencias sistemáticas fijas, n, vy s ignorará las banderas de bits
relacionados con la navegación, los valores de los datos y las pendientes de los datos, respectivamente. Usar -A + e a
reemplace las correcciones de E77 existentes en el archivo con los nuevos valores. Finalmente, e77
las correcciones no se aplicarán si el archivo E77 no ha sido verificado. Usar -AE a
ignore el estado de verificación.

g Muestra una cuadrícula geográfica GMT (lon, lat) a lo largo de la pista proporcionada por el archivo MGD77 +
utilizando interpolación bicúbica (sin embargo, consulte -n). Agregue el nombre de un archivo de cuadrícula GMT.

i Muestra una cuadrícula de Sandwell / Smith Mercator * .img a lo largo de la pista proporcionada por el MGD77 +
archivo utilizando interpolación bicúbica (sin embargo, consulte -n). Agregue el nombre de archivo de la cuadrícula img,
seguido de la escala de datos separados por comas (normalmente 1 o 0.1), el modo de archivo IMG
(0-3) y, opcionalmente, la latitud máxima de la cuadrícula img [80.738]. Los modos representan el
siguiente: (0) archivos Img sin código de restricción, devuelve datos en todos los puntos, (1)
Archivo Img con restricciones codificadas, devuelve datos en todos los puntos, (2) Archivo Img con
restricciones codificadas, devuelven datos solo en puntos restringidos y NaN en otros lugares, y
(3) Archivo Img con restricciones codificadas, devuelve 1 en las restricciones y 0 en cualquier otro lugar.

n Agregue el nombre de archivo de una tabla de dos columnas con la primera columna que contiene el registro
número (0 a nrows - 1) y la segunda columna contiene valores de datos. Si no hay archivo
dado que leemos de stdin en su lugar. Registros con números de registro coincidentes en el
Al archivo MGD77 + se le asignarán los nuevos valores; en otros registros, los configuramos en NaN.

t Agregue el nombre de archivo de una tabla de dos columnas con la primera columna que contiene absoluto
tiempos a lo largo de la pista y la segunda columna contiene valores de datos. Si no se entrega ningún archivo,
leer de stdin en su lugar. Los registros con tiempos coincidentes en el archivo MGD77 + serán
asignó los nuevos valores; en otras ocasiones, los configuramos en NaN. Alternativamente, da
mayúscula T en su lugar, interpolaremos la columna en todos los tiempos de registro.

-Cf | g | e
Agregue un código de una letra para seleccionar el procedimiento para la distancia a lo largo de la trayectoria
cálculo al usar -Anuncio|D (consulta: -N para seleccionar unidades de distancia):

f Distancias terrestres planas.

g Grandes distancias circulares [predeterminado].

e Distancias geodésicas en elipsoide GMT actual.

-Dabrev1,abrev2, ...)
Proporcione una lista separada por comas de las abreviaturas de las columnas de las que desea eliminar
los archivos MGD77 +. NO use esta opción para eliminar columnas que está reemplazando
con nuevos datos (usar -A + en lugar de). Porque no podemos eliminar variables de netCDF
archivos debemos crear un nuevo archivo sin las columnas a eliminar. Una vez que el archivo está
creado correctamente, cambiamos temporalmente el nombre del archivo antiguo, cambiamos el nuevo nombre de archivo a
el antiguo nombre de archivo y, finalmente, elimine el antiguo archivo renombrado.

-Evacío
Dar un solo carácter que se repetirá para llenar valores de cadena vacíos, por ejemplo,
"9" producirá una cadena como "99999 ..." [9].

-F Modo de fuerza. Cuando este modo está activo, puede eliminar o reemplazar incluso
el conjunto de columnas estándar MGD77. ¡Es mejor que sepas lo que estás haciendo!

-Iabrev/nombre /unidad/ t /escala/compensar/comentario
Además de la información del archivo, debemos especificar información adicional sobre el
columna extra. Especifique un número corto (16 caracteres o menos, utilizando letras minúsculas, dígitos,
o guiones bajos solamente) abreviatura de los datos seleccionados, su nombre más descriptivo,
la unidad de datos, el tipo de datos código de 1 carácter (bsí, scorto, fdetestable iNuevo Testamento, ddoble, o
text) que desee utilizar para el almacenamiento en el archivo netCDF, cualquier escala y compensación deberíamos
aplicar a los datos para que encajen dentro del rango implícito en el almacenamiento elegido
tipo, y un comentario general (<128 caracteres) sobre lo que representan estos datos.
Nota: Si se selecciona el tipo de datos de texto, los términos "valores" en el -A discusión
consulte sus datos de texto. Además, la discusión sobre la interpolación no
aplicar y el valor de NaN se convierte en un valor "sin cadena" (consulte -E por lo que es esto).
Coloque comillas alrededor de términos con más de una palabra (por ejemplo, "Profundidad corregida").

-Nunidad Agregue la unidad de distancia (consulte UNIDADES). [El valor predeterminado es -Nk (km)]. Solo relevante cuando
-ag|i se selecciona.

-R [unidad]xmín/xmax/ymin/ymax[r] (más ...)
Especifique la región de interés. Solo relevante cuando -ag|i se selecciona.

-V [nivel] (más ...)
Seleccione el nivel de verbosidad [c].

-bi[ncoles] [t] (más ...)
Seleccione la entrada binaria nativa. Esto se aplica a los archivos de datos de entrada de 1 o 2 columnas.
especificado en algunos de los -A opciones. La opción de entrada binaria solo está disponible
para columnas de datos numéricos.

-dusin datos (más ...)
Reemplazar columnas de entrada que sean iguales sin datos con NaN.

-n [b | c | l | n] [+ a] [+ bBC] [+ c] [+ tumbral] (más ...)
Seleccione el modo de interpolación para cuadrículas.

-^ or solo -
Imprima un mensaje corto sobre la sintaxis del comando, luego sale (NOTA: en Windows
usar solo -).

-+ or solo +
Imprima un mensaje de uso extenso (ayuda), incluida la explicación de cualquier
opción específica del módulo (pero no las opciones comunes de GMT), luego sale.

-? or no argumentos
Imprima un mensaje de uso completo (ayuda), incluida la explicación de las opciones, luego
salidas

--versión
Imprime la versión GMT y sal.

--show-datadir
Imprima la ruta completa al directorio compartido GMT y salga.

BODEGAS

Para la unidad de distancia del mapa, agregue unidad d para el grado de arco, m por minuto de arco, y s para arco
segundo, o e para el medidor [predeterminado], f para pie, k por km, M por la milla del estatuto, n para náutica
milla, y u para pie topográfico de EE. UU. Por defecto, calculamos tales distancias utilizando un esférico.
aproximación con grandes círculos. Anteponer - a una distancia (o la unidad no es ninguna distancia es
dado) para realizar cálculos de "Tierra plana" (más rápido pero menos preciso) o anteponer + a
realizar cálculos geodésicos exactos (más lento pero más preciso).

CONSECUENCIAS OF GRID VOLVER A MUESTREAR

El remuestreo o muestreo de cuadrículas utilizará varios algoritmos (consulte -n) que puede conducir a
posibles distorsiones o resultados inesperados en los valores remuestreados. Un efecto esperado
del remuestreo con splines es la tendencia de los nuevos valores remuestreados a exceder ligeramente
los límites mínimos / máximos globales de la cuadrícula original. Si esto es inaceptable, puede imponer
recorte de los valores remuestreados para que no excedan los valores mínimos / máximos de entrada por
la adición de +c para usted -n .

EJEMPLOS

Para agregar Geosat / ERS-1 gravity versión 11.2 como una columna de datos extra en los cruceros
01010047.nc y 01010008.nc, almacenando los valores como mGal * 10 en un entero corto de 2 bytes, intente

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

Para agregar una versión filtrada de magnetics como una columna de datos extra de tipo float para el
Cruise 01010047.nc e interpolar los datos filtrados en los tiempos indicados en el MGD77 +
archivo, prueba

gmt mgd77manage 01010047 -ATmymag.tm -Ifiltmag / "Intermediate-wavelength \
residuales magnéticos "/" nTesla "/ f / 1/0 /" Útil para buscar isócronas "-V

Para eliminar las columnas adicionales existentes satfaa, coastdist y satvgg de todos los archivos MGD77 +,
try

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

Para crear una columna flotante de 4 bytes con el campo de referencia IGRF correcto en todos los archivos MGD77 +,
try

gmt mgd77manage = allmgd77.lis -Acm -Iigrf / "referencia IGRF \
campo "/" nTesla "/ f / 1/0 /" IGRF versión 10 para 1990-2010 "-V

DISCUSIÓN

1. Preámbulo

El suplemento mgd77 es un intento de (1) mejorar la funcionalidad limitada del
suplemento mgg existente, (2) incorporar algunas de las ideas del suplemento gmt + de Scripps
al permitir columnas de datos adicionales y (3) agregar nuevas capacidades para la gestión marina
datos de la línea de trayectoria geofísica almacenados en un CF-1.0 independiente de la arquitectura y
Formato de archivo netCDF compatible con COARDS. A continuación, se incluyen algunas de las ideas subyacentes y los pasos que
necesita tomar para mantener sus archivos.

2. Introducción

Nuestro punto de partida son los archivos de datos MGD77 ASCII distribuidos desde NGDC en CD-ROMS,
DVD-ROMS y vía FTP. Usando Geodas para instalar los archivos localmente elegimos el "Carter
"profundidad corregida" opción que llenará la columna de profundidad utilizando los tiempos de viaje de ida y vuelta
y las tablas de Carter si twt está presente. Este paso produce ~ 5000 archivos de crucero individuales.
Colóquelos en uno o más subdirectorios de su elección, enumere estos subdirectorios (uno
por línea) en el archivo mgd77_paths.txt, y coloque ese archivo en el directorio al que apunta
$ MGD77_HOME; si no se establece, esta variable predeterminada es $ GMT_SHAREDIR/ mgd77.

3. Conversión

Convierta los archivos ASCII MGD77 al nuevo formato netCDF MGD77 + usando mgd77convertir.
Normalmente, hará una lista de todos los cruceros que se convertirán (con o sin
extensión), y luego ejecuta
mgd77convert = cruceros.lis -Fa -Tc -V -Lwe +> log.txt

La configuración detallada garantizará que todos los problemas encontrados durante la conversión sean
informó. Los nuevos archivos * .nc también se pueden colocar en uno o más subdirectorios separados
y estos también deben aparecer en el archivo mgd77_paths.txt. Le sugerimos que coloque el
directorios con archivos * .nc antes de los directorios * .mgd77. Cuando luego quieras limitar
una búsqueda de archivos de una determinada extensión debe utilizar el -I .

4. Adición nueva columnas

mgd77gestionar le permitirá agregar columnas de datos adicionales a sus archivos * .nc. Estos pueden ser
cualquier cosa, incluidas las cadenas de texto, pero lo más probable es que sean valores numéricos muestreados a lo largo del
rastrear desde una cuadrícula suministrada o una columna existente que se haya filtrado o manipulado
para un propósito particular. El formato admite hasta 32 columnas adicionales de este tipo. Ver a este hombre
página para saber cómo agregar columnas. Más tarde, puede decidir eliminar algunas de estas columnas o
actualizar los datos asociados con una determinada columna. Herramientas de extracción de datos como Lista mgd77
se puede utilizar para extraer una combinación de columnas MGD77 estándar (navegación, tiempo y el habitual
observaciones geofísicas) y sus columnas personalizadas.

5. Error fuentes

Antes de discutir cómo corregir errores, primero enumeraremos las diferentes clases de errores
asociado con datos MGD77: (1) Los errores de registro de encabezado ocurren cuando parte de la información
Los campos en el encabezado no cumplen con la especificación MGD77 o la información requerida es
faltante. mgd77convertir enumerará estos errores cuando la configuración detallada ampliada sea
seleccionado. Estos errores normalmente no afectan los datos y son, en cambio, errores en el
metadatos (2). Los errores sistemáticos fijos ocurren cuando una columna de datos en particular, a pesar de la
La especificación MGD77 se ha codificado incorrectamente. Esto generalmente significa que los datos estarán desactivados
por un factor constante como 10 o 0.1, o en algunos casos incluso 1.8288 que convierte
brazas a metros. (3) Se producen errores sistemáticos desconocidos cuando el instrumento que registró
Los datos o el procesamiento que siguió introdujeron señales que parecen ser sistemáticas.
funciones del tiempo a lo largo de la trayectoria, latitud, rumbo o alguna otra combinación de términos que
tener una explicación física o lógica. Estos términos a veces pueden resolverse mediante datos
técnicas de análisis tales como investigaciones a lo largo de la vía y a lo largo de la vía, y resultará
en términos de corrección que cuando se aplica a los datos eliminará estas señales no deseadas en un
forma óptima. Debido a que estos términos de corrección pueden cambiar cuando se consideran nuevos datos en
su determinación, tales correcciones se consideran efímeras. (4) Datos individuales
puntos o secuencias de datos pueden violar reglas tales como estar fuera de los rangos posibles o
de otras formas violan la cordura. Además, las secuencias de puntos que pueden estar dentro
los rangos pueden dar lugar a gradientes de datos que no son razonables. El estado de cada punto
por lo tanto, se puede determinar y esto da lugar a indicadores de bits BUENO o MALO. Nuestra politica es
que las fuentes de error 1, 2 y 4 se corregirán proporcionando la información como metadatos
en los archivos * .nc relevantes, mientras que las correcciones para la fuente de error 3 (porque
se mejorará constantemente) se mantendrá en una lista separada de correcciones.

6. Encontrar errores

El mgd77sniffer es una herramienta que realiza una verificación exhaustiva a lo largo de la pista del original
MGD77 archivos ASCII y genera un registro de errores * .e77 correspondiente. Todos los problemas encontrados son
codificados en el registro de errores, y se dan los términos de corrección fijos recomendados, si es necesario. Un
El analista puede verificar que las correcciones sugeridas son realmente válidas (solo queremos
corregir errores de unidad realmente obvios), editar estos registros de errores y modificar dichos términos de corrección
y actívelos cambiando la clave del código correspondiente (ver mgd77sniffer para más detalles).
mgd77gestionar puede ingerir estos registros de error y (1) corregir los registros de encabezado incorrectos dada la
sugerencias en el registro, (2) inserte los términos de corrección de escala / compensación que se utilizarán al leer
ciertas columnas, e (3) inserte cualquier bit-flag encontrado. Vuelva a ejecutar este paso si luego encuentra
otros problemas, ya que todas las configuraciones o indicadores de E77 se volverán a crear en función del último registro de E77.

7. Error correcciones

El programa de extracción Lista mgd77 permite que las correcciones se apliquen sobre la marcha cuando los datos
son solicitados. En primer lugar, se suprimen los datos con indicadores de bits MALOS. En segundo lugar, datos con fijo
Los términos de corrección sistemática se corrigen en consecuencia. En tercer lugar, datos con efímeros
Los términos de corrección tendrán esas correcciones aplicadas (si se proporciona una tabla de corrección).
Todos estos pasos requieren la presencia de los metadatos relevantes y todos pueden anularse
por el usuario. Además, los usuarios pueden agregar sus propias banderas de bits como columnas de datos separadas y
utilizan el Lista mgd77pruebas lógicas para dictar aún más qué datos se suprimen de la salida.

CRÉDITOS

Los cálculos de IGRF se basan en un programa de Fortran escrito por Susan Macmillan, británica
Geological Survey, traducido a C vía f2c por Joaquim Luis, y adaptado al estilo GMT por
Pablo Wessel.

Use mgd77managegmt en línea usando los servicios de onworks.net