x2sys_initgmt: en línea en la nube

PROGRAMA:

NOMBRE

x2sys_init: inicializa una nueva base de datos de pistas x2sys

SINOPSIS

x2sys_init ETIQUETA contaminar [ c|f|g|e ] [ sufijo ] [] [ d|g ] [ dx[/dy]] [ d|sunidad ] [
región ] [[nivel]] [ t|dbrecha ]

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

DESCRIPCIÓN

x2sys_init es el punto de partida para cualquiera que desee utilizar x2sys; inicializa un conjunto de
bases de datos que son particulares de un tipo de datos de seguimiento. Estos datos, sus asociados
bases de datos y parámetros clave reciben una notación abreviada llamada x2sys TAG. los
TAG realiza un seguimiento de la configuración, como el formato de archivo, si los datos son geográficos o no,
y la resolución de agrupamiento para índices de seguimiento. Corriendo x2sys_init es un requisito previo para
ejecutando cualquiera de los otros programas x2sys, como x2sys_binlist, que creará un crudo
Representación de dónde va cada pista de datos dentro del dominio y qué observaciones son
disponible; esta información sirve como entrada para x2sys_put que actualiza los datos de la pista
base. Luego, x2sys_get se puede utilizar para encontrar qué pistas y datos están disponibles dentro de un
región dada. Con esa lista de pistas puedes usar x2sys_cruz para calcular la pista
cruces, uso informe_x2sys para informar estadísticas cruzadas o x2sys_lista Sacar
información de cruce seleccionada que x2sys_solve puede utilizar para determinar la pista específica
correcciones sistemáticas. Estas correcciones se pueden utilizar con x2sys_lista de datos extraer
valores de datos corregidos para su uso en trabajos posteriores. Porque puedes correr x2sys_init que tú deben
establezca el parámetro ambiental X2SYS_HOME en un directorio donde tenga permiso de escritura,
que es donde x2sys puede realizar un seguimiento de su configuración.

REQUERIDOS ARGUMENTOS

ETIQUETA El nombre exclusivo de este tipo de datos x2sys TAG.

-Dcontaminar
Prefijo de archivo de definición para este conjunto de datos [Consulte ARCHIVOS DEFINICIÓN a continuación para obtener más información
información]. Especifique la ruta completa si el archivo no está en el directorio actual.

OPCIONAL ARGUMENTOS

-Cc | f | g | e
Seleccione el procedimiento para el cálculo de la distancia a lo largo de la trayectoria cuando lo necesiten otros
programas:

c Distancias cartesianas [predeterminado, a menos que -G Está establecido].

f Distancias terrestres planas.

g Grandes distancias circulares [Predeterminado si -G Está establecido].

e Distancias geodésicas en elipsoide GMT actual.

-Esufijo
Especifica la extensión de archivo (sufijo) para estos archivos de datos. Si no se da usamos el
prefijo del archivo de definición como sufijo (consulte -D).

-F Forzar la creación de nuevos archivos si hay antiguos [El valor predeterminado se cancelará si el TAG antiguo
se encuentran archivos].

-Gd | g Selecciona coordenadas geográficas. Adjuntar d por discontinuidad en el Dateline (hace
longitud va de -180 a + 180) o g por discontinuidad en Greenwich (hace
la longitud va de 0 a 360 [predeterminado]). Si no se da, asumimos que los datos son
Cartesiano.

-Idx[/dy]
x_inc [y opcionalmente y_inc] es el espaciado de la cuadrícula. Adjuntar m para indicar minutos o c
para indicar segundos para datos geográficos. Estos espacios se refieren al agrupamiento utilizado
en la base de datos del índice bin de pistas.

-Nd | sunidad
Establece las unidades utilizadas para la distancia y la velocidad cuando lo solicitan otros programas. Adjuntar
d por distancia o s para velocidad, luego dale el unidad as c (Userdist cartesiano
o userdist / usertime), e (metros om / s), f (pies o pies / s), k (km o kms / h), m
(millas o millas / h), n (millas náuticas o nudos) o u (pies de encuesta o encuesta
pies / s). [El valor predeterminado es -Ndk -Nse (km y m / s) si -G está configurado y -Ndc y -NSC
de lo contrario (unidades cartesianas)].

-R [unidad]oeste/este/sur/norte[/zmín/zmáx] [r]
oeste, este, sur y norte especificar la región de interés, y puede especificar
en grados decimales o en formato [+ -] dd: mm [: ss.xxx] [W | E | S | N]. Adjuntar r si es menor
Las coordenadas del mapa izquierda y superior derecha se dan en lugar de w / e / s / n. Los dos
taquigrafía -Rg y -Rd significa dominio global (0/360 y -180 / + 180 de longitud
respectivamente, con -90 / + 90 en latitud). Alternativamente, para la creación de cuadrículas, dé
Rcodelón/lat/nx/ny, donde el código es una combinación de 2 caracteres de L, C, R (para la izquierda,
centro o derecha) y T, M, B para arriba, medio o abajo. por ejemplo, BL para la parte inferior izquierda.
Esto indica en qué punto de una región rectangular lon/lat coordinar se refiere
a, y las dimensiones de la cuadrícula nx y ny con espaciamiento de cuadrícula vía -I se usa para crear
la región correspondiente. Alternativamente, especifique el nombre de un archivo de cuadrícula existente
y -R la configuración (y el espaciado de la cuadrícula, si corresponde) se copian de la cuadrícula.
Usando -Runidad espera coordenadas proyectadas (cartesianas) compatibles con las elegidas -J
y proyectamos inversamente para determinar la región geográfica rectangular real. Para
vista de perspectiva (-p), opcionalmente anexar /zmín/zmáx. En caso de vista en perspectiva
(-p), un rango z (zmín, zmáx) se puede agregar para indicar la tercera dimensión. Esta
debe hacerse solo cuando se utiliza el -Jz opción, no cuando se usa solo la -p .
En el último caso, se traza una vista en perspectiva del plano, sin una tercera
dimensión. Para datos cartesianos, simplemente dé xmin / xmax / ymin / ymax. Esta opción basa el
estadísticas sobre aquellos COE que caen dentro del dominio especificado.

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

-Peso | dbrecha
Dar t or d y agregue el intervalo de tiempo máximo correspondiente (en unidades de usuario; esto es
normalmente segundos [Infinito]) o distancia (para unidades, consulte) espacio [Infinito])
permitido entre los dos puntos de datos inmediatamente a cada lado de un cruce. Si
estos límites se exceden, entonces se supone una brecha de datos y no se determinará ningún COE.

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

-+ or tan 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.

DEFINICIÓN ARCHIVOS

Estos archivos * .def contienen información sobre el formato del archivo de datos y tienen dos secciones:
(1) información del encabezado y (2) información de la columna. Toda la información del encabezado comienza con el
carácter # en la primera columna, seguido inmediatamente por una directiva en mayúsculas. Si el
La directiva toma un argumento y está separada por espacios en blanco. Puede agregar un # al final
comentarios. Se reconocen cinco directivas:

ASCII indica que los archivos de datos están en formato ASCII.

BINARIO establece que los archivos de datos son archivos binarios nativos.

NETCDF establece que los archivos de datos son archivos 1-D netCDF compatibles con COARDS.

OMITIR toma un argumento entero que es el número de líneas para omitir (al leer
Archivos ASCII) o la cantidad de bytes que se deben omitir (al leer archivos binarios nativos). No utilizado
con archivos netCDF.

GEO indica que estos archivos son conjuntos de datos geográficos, con periodicidades en el
x-coordinada (longitudes). Alternativamente, use -G.

MULTISEG significa que cada pista consta de varios segmentos separados por un encabezado de segmento GMT
(alternativamente, use -m al definir el sistema TAG). No se utiliza con archivos netCDF.

La información de la columna consta de una línea por columna en el orden en que aparecen las columnas.
el archivo de datos. Para cada columna debe proporcionar siete atributos:

nombre tipo Yaya Proxy NaN escala compensar oformato

nombre es el nombre de la variable de columna. Se espera que utilice el especial
nombres lon (o x si es cartesiano) y lat (o y) para las dos columnas de coordenadas requeridas, y
time cuando hay datos de tiempo opcionales.

tipo es siempre a para representaciones ASCII de números, mientras que para archivos binarios puede
elegir entre c para caracteres de 1 byte con signo (-127, + 128), u para byte sin firmar (0-255), h para
enteros de 2 bytes con signo (-32768, + 32767), i para enteros de 4 bytes con signo
(-2,147,483,648, + 2,147,483,647), f para puntos flotantes de 4 bytes y d para doble de 8 bytes
puntos flotantes de precisión. Para netCDF, simplemente use d ya que netCDF manejará automáticamente
conversiones de tipo durante la lectura.

Yaya es Y si ciertos valores (por ejemplo, -9999) deben ser reemplazados por NAN, y N en caso contrario.

Proxy NaN es ese valor especial (por ejemplo, -9999).

escala se utiliza para multiplicar los datos después de la lectura.

compensar se utiliza para agregar a los datos escalados.

oformato es una cadena de formato de estilo C que se utiliza para imprimir valores de esta columna.

Si das - como el oformato en su lugar, se utilizará la maquinaria de formato de GMT (es decir,
FORMAT_FLOAT_OUT, FORMAT_GEO_MAP, FORMAT_DATE_MAP, FORMAT_CLOCK_MAP). Algunos formatos de archivo
ya tiene archivos de definición predefinidos. Estos incluyen mgd77 (para datos ASCII MGD77 simples
archivos), mgd77 + (para archivos MGD77 + netCDF mejorados), gmt (para archivos binarios
archivos), xy (para tablas ASCII x, y), xyz (lo mismo, con una columna z), geo (para
Longitud ASCII, archivos de latitud) y geoz (lo mismo, con una columna z).

EJEMPLOS

Si tiene un gran conjunto de archivos de datos de pistas, puede organizarlos con las herramientas x2sys.
Aquí describiremos los pasos. Supongamos que el formato de archivo de datos de su pista consta de
2 registros de encabezado con información de texto seguida de cualquier número de formato idéntico
registros de datos con 6 columnas (lat, lon, time, obs1, obs2, obs3) y que los archivos se llaman
* .trk. A esto lo llamaremos formato de "línea". Primero, creamos el archivo line.def:

┌─────────────┬──────────────┬─────┬───────────┬── ─────┬────────┬─────────┐
│ # Definir │ │ │ │ │ │ │
│archivo para el │ │ │ │ │ │ │
│formato de línea │ │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│ # SALTAR 2 │ # Saltar 2 │ │ │ │ │ │
│ │ encabezado │ │ │ │ │ │
│ │ registros │ │ │ │ │ │
└─────────────┴──────────────┴─────┴────────────┴── ─────┴────────┴─────────┘

│ # GEO │ # Los datos son │ │ │ │ │ │
│ │ geográfico │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│ # nombre │ tipo │ NaN │ NaN-proxy │ escala │ desplazamiento │ de formato │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│lat │ a │ N │ 0 │ 1 │ 0 │% 9.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│lon │ a │ N │ 0 │ 1 │ 0 │% 10.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│tiempo │ a │ N │ 0 │ 1 │ 0 │% 7.1f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│obs1 │ a │ N │ 0 │ 1 │ 0 │% 7.2f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│obs2 │ a │ N │ 0 │ 1 │ 0 │% 7.2f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│obs3 │ a │ N │ 0 │ 1 │ 0 │% 7.2f │
└─────────────┴──────────────┴─────┴────────────┴── ─────┴────────┴─────────┘

A continuación, creamos el directorio TAG y TAG con las bases de datos para estas líneas de seguimiento.
archivos. Suponiendo que estos contienen datos geográficos y que queremos realizar un seguimiento de los datos
distribución a una resolución de 1 x 1 grado, con distancias en km calculadas a lo largo de geodésicas
y con velocidades expresadas en nudos, podemos correr

gmt x2sys_init LINE -V -G -Dline -Rg -Ce -Ndk -NsN -I1 / 1 -Etrk

donde hemos seleccionado LINE para ser nuestra etiqueta x2sys. Cuando las herramientas x2sys intentan leer su línea
archivos de datos, primero buscarán en el directorio actual y luego buscarán en el archivo
ETIQUETA_paths.txt para obtener una lista de directorios adicionales para examinar. Por lo tanto, cree un
file (aquí LINE_paths.txt) y pegue las rutas completas a sus directorios de datos allí. Todos
Los archivos relacionados con TAG (archivos de definición, archivos de etiquetas y bases de datos de pistas creadas)
se espera que esté en el directorio al que apunta $ X2SYS_HOME/ETIQUETA (en nuestro caso
$ X2SYS_HOME/LÍNEA). Tenga en cuenta que el argumento para -D debe contener la ruta completa si el * .def
El archivo no está en el directorio actual. x2sys_init copiará este archivo a la
$ X2SYS_HOME/ETIQUETA directorio donde todas las demás herramientas x2sys esperarán encontrarlo.

Crear tbf archivo (s):
Una vez que se han inicializado las bases de datos TAG (vacías), pasamos por un proceso de dos pasos
proceso para poblarlos. Primero corremos x2sys_binlist en todos nuestros archivos de seguimiento para
cree uno (o más) archivos de índice bin de pistas de varios segmentos (tbf). Estos contienen
información sobre qué contenedores de 1 x 1 grado (o cualquier otro tamaño de bloque; consulte -I) cada pista
ha visitado y qué observaciones (en su caso obs1, obs2, obs3) fueron realmente
observado (no todas las pistas pueden tener los tres tipos de observaciones en todas partes). Para
Por ejemplo, si sus pistas están listadas en el archivo tracks.lis, podemos ejecutar este comando:

gmt x2sys_binlist -V -TLINE: tracks.lis> tracks.tbf

Actualizar índice datos base:
A continuación, los archivos de índice de bandeja de seguimiento se envían a x2sys_put que insertará el
información en las bases de datos de TAG:

gmt x2sys_put -V -TLINE pistas.tbf

Buscar para datos:
Ahora puedes usar x2sys_get para encontrar todas las pistas dentro de una determinada subregión, y
Opcionalmente, limite la búsqueda a aquellas pistas que tengan una combinación particular de
observables. Por ejemplo, para encontrar todas las pistas que tienen obs1 y obs3 dentro del
región especificada, ejecutar

gmt x2sys_get -V -TLINE -R20 / 40 / -40 / -20 -Fobs1, obs3> tracks.tbf

MGD77 [+] or GMT:
Los archivos de definición ya existen para archivos MGD77 (tanto ASCII estándar como mejorado
archivos MGD77 + basados ​​en netCDF) y los archivos * .gmt antiguos manipulados por mgg
suplementos; para estos conjuntos de datos -C y -N estará por defecto en el gran círculo
cálculo de distancia en km y velocidad en m / s. También hay archivos de definición para
pistas x, y [, z] y lon, lat [, z] simples. Para iniciar nuevas bases de datos de pistas que se utilizarán
con datos MGD77 de NGDC, intente

gmt x2sys_init MGD77 -V -Dmgd77 -Emgd77 -Rd -Gd -Nsn -I1 / 1 -Wt900 -Wd5

donde hemos elegido un umbral de 15 minutos (900 segundos) o 5 km para indicar una brecha de datos
y nudos seleccionados como la velocidad; los otros pasos son similares.

Binario archivos:
Supongamos que sus archivos de línea son en realidad archivos binarios con 128 bytes
la estructura del encabezado (que debe omitirse) seguida de los registros de datos y donde lon, lat,
time son números de doble precisión, mientras que las tres observaciones son números enteros de 2 bytes
que debe multiplicarse por 0.1. Finalmente, las dos primeras observaciones pueden ser -32768
lo que significa que no hay datos disponibles. Todo lo que se necesita es una línea diferente.
archivo:

┌─────────────┬──────────────┬─────┬───────────┬── ─────┬────────┬─────────┐
│ # Definir │ │ │ │ │ │ │
│archivo para el │ │ │ │ │ │ │
│línea binaria │ │ │ │ │ │ │
│formato │ │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│ # BINARY │ # El archivo es │ │ │ │ │ │
│ │ ahora binario │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│ # SALTAR 128 │ # Saltar 128 │ │ │ │ │ │
│ │ bytes │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│ # GEO │ # Los datos son │ │ │ │ │ │
│ │ geográfico │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│ # nombre │ tipo │ NaN │ NaN-proxy │ escala │ desplazamiento │ de formato │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│lon │ d │ N │ 0 │ 1 │ 0 │% 10.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│lat │ re │ N │ 0 │ 1 │ 0 │% 9.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│tiempo │ d │ N │ 0 │ 1 │ 0 │% 7.1f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│obs1 │ h │ Y │ -32768 │ 0.1 │ 0 │% 6.1f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│obs2 │ h │ Y │ -32768 │ 0.1 │ 0 │% 6.1f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│obs3 │ h │ N │ 0 │ 0.1 │ 0 │% 6.1f │
└─────────────┴──────────────┴─────┴────────────┴── ─────┴────────┴─────────┘

El resto de los pasos son idénticos.

GRUESAS 1-D netCDF archivos:
Finalmente, suponga que sus archivos de línea son en realidad archivos netCDF que se ajustan a la
Convención COARDS, con columnas de datos denominadas lon, lat, time, obs1, obs2 y obs3.
Todo lo que se necesita es un archivo line.def diferente:

┌─────────────┬──────────────┬─────┬───────────┬── ─────┬────────┬─────────┐
│ # Definir │ │ │ │ │ │ │
│archivo para el │ │ │ │ │ │ │
│netCDF │ │ │ │ │ │ │
│COARDS línea │ │ │ │ │ │ │
│formato │ │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│ # NETCDF │ # El archivo es │ │ │ │ │ │
│ │ ahora netCDF │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│ # GEO │ # Los datos son │ │ │ │ │ │
│ │ geográfico │ │ │ │ │ │
└─────────────┴──────────────┴─────┴────────────┴── ─────┴────────┴─────────┘

│ # nombre │ tipo │ NaN │ NaN-proxy │ escala │ desplazamiento │ de formato │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│lon │ d │ N │ 0 │ 1 │ 0 │% 10.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│lat │ re │ N │ 0 │ 1 │ 0 │% 9.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│tiempo │ d │ N │ 0 │ 1 │ 0 │% 7.1f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│obs1 │ d │ N │ 0 │ 1 │ 0 │% 6.1f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│obs2 │ d │ N │ 0 │ 1 │ 0 │% 6.1f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│obs3 │ d │ N │ 0 │ 1 │ 0 │% 6.1f │
└─────────────┴──────────────┴─────┴────────────┴── ─────┴────────┴─────────┘

Tenga en cuenta que no usamos proxies NAN ni escalado, ya que esos problemas generalmente se manejan
internamente en la descripción de formato netCDF.

Utilice x2sys_initgmt en línea utilizando los servicios de onworks.net