x2sys_initgmt - En ligne dans le Cloud

PROGRAMME:

Nom

x2sys_init - Initialiser une nouvelle base de données de pistes x2sys

SYNOPSIS

x2sys_init TAG défile [ c|f|g|e ] [ suffixe ] [ ] [ d|g ] [ dx[/dy] ] [ d|sunité ] [
région ] [ [niveau] ] [ t|décart ]

Remarque: Aucun espace n'est autorisé entre l'indicateur d'option et les arguments associés.

DESCRIPTION

x2sys_init est le point de départ pour quiconque souhaite utiliser x2sys ; il initialise un ensemble de
bases de données spécifiques à un type de données de voie. Ces données, leurs données associées
bases de données et les paramètres clés reçoivent une notation abrégée appelée TAG x2sys.
TAG garde une trace des paramètres tels que le format de fichier, si les données sont géographiques ou non,
et la résolution de binning pour les indices de piste. x2sys_init est une condition préalable à
exécuter l'un des autres programmes x2sys, tels que x2sys_binlist, ce qui créera un pétrole brut
représentation de l'endroit où chaque piste de données va dans le domaine et quelles observations sont
disponible ; ces informations servent d'entrée à x2sys_put qui met à jour les données de piste
base. Ensuite, x2sys_get peut être utilisé pour trouver quelles pistes et données sont disponibles dans un
région donnée. Avec cette liste de pistes, vous pouvez utiliser x2sys_cross pour calculer la piste
croisements, utilisation rapport_x2sys pour signaler des statistiques de croisement ou liste_x2sys se retirer
informations de croisement sélectionnées qui x2sys_solve peut être utilisé pour déterminer les spécificités de la piste
corrections systématiques. Ces corrections peuvent être utilisées avec x2sys_datalist extraire
valeurs de données corrigées pour une utilisation ultérieure. Parce que vous pouvez exécuter x2sys_init vous doit
définissez le paramètre environnemental X2SYS_HOME sur un répertoire pour lequel vous disposez d'une autorisation d'écriture,
c'est là que x2sys peut suivre vos paramètres.

REQUIS ARGUMENTS

TAG Le nom unique de ce type de données x2sys TAG.

-Ddéfile
Préfixe du fichier de définition pour cet ensemble de données [Voir FICHIERS DE DÉFINITION ci-dessous pour plus d'informations
[information]. Spécifiez le chemin complet si le fichier ne se trouve pas dans le répertoire courant.

EN OPTION ARGUMENTS

-Cc|f|g|e
Sélectionnez la procédure de calcul de la distance le long de la voie lorsque cela est nécessaire pour d'autres
programmes:

c Distances cartésiennes [Par défaut, sauf si -G est défini].

f Distances de la Terre plate.

g Distances du grand cercle [Par défaut si -G est défini].

e Distances géodésiques sur l'ellipsoïde GMT actuel.

-Esuffixe
Spécifie l'extension de fichier (suffixe) de ces fichiers de données. Si elle n'est pas spécifiée, nous utilisons
préfixe du fichier de définition comme suffixe (voir -D).

-F Forcer la création de nouveaux fichiers si d'anciens sont présents [La valeur par défaut s'arrêtera si l'ancien TAG
[des fichiers sont trouvés].

-Dieu|g Sélectionne les coordonnées géographiques. Ajouter d pour discontinuité à la ligne de changement de date (rend
longitude va de -180 à + 180) ou g pour la discontinuité à Greenwich (rend
longitude allant de 0 à 360 [par défaut]). Si elle n'est pas fournie, nous supposons que les données sont
Cartésien.

-Idx[/dy]
x_inc [et éventuellement y_inc] est l'espacement de la grille. Ajouter m pour indiquer les minutes ou c
Pour indiquer les secondes des données géographiques. Ces espacements font référence au classement utilisé.
dans la base de données d'index des bacs de piste.

-Nd|sunité
Définit les unités utilisées pour la distance et la vitesse lorsque d'autres programmes le demandent.
d pour la distance ou s pour la vitesse, puis donnez le unité as c (Userdiste cartésien
ou userdist/usertime), e (mètres ou m/s), f (pieds ou pieds/s), k (km ou km/h), m
(miles ou miles/h), n (milles nautiques ou nœuds) ou u (pieds d'arpentage ou d'arpentage
pieds/s). [La valeur par défaut est -Ndk -Nse (km et m/s) si -G est réglé et -Ndc et -Nsc
sinon (unités cartésiennes)].

-R[unité]ouest/est/sud/nord[/zmin/zmax][r]
ouest, est, sudet nord spécifiez la région d'intérêt, et vous pouvez spécifier
en degrés décimaux ou au format [+-]dd:mm[:ss.xxx][W|E|S|N]. Ajouter r si inférieur
les coordonnées de gauche et en haut à droite de la carte sont données au lieu de w/e/s/n. Les deux
raccourcis -Rg et -Rd signifie domaine global (0/360 et -180/+180 en longitude
respectivement, avec -90/+90 en latitude). Alternativement pour la création de grille, donnez
Rcodelon/lat/nx/ny, Où code est une combinaison de 2 caractères de L, C, R (pour gauche,
au centre ou à droite) et T, M, B pour le haut, le milieu ou le bas. par exemple, BL pour le coin inférieur gauche.
Ceci indique quel point sur une région rectangulaire le lon/lat la coordonnée fait référence
à, et les dimensions de la grille nx et ny avec des espacements de grille via -I est utilisé pour créer
la région correspondante. Vous pouvez également spécifier le nom d'un fichier de grille existant
et la -R les paramètres (et l'espacement de la grille, le cas échéant) sont copiés à partir de la grille.
En utilisant -Runité attend des coordonnées projetées (cartésiennes) compatibles avec celles choisies -J
et nous projetons inversement de déterminer la région géographique rectangulaire réelle. Pour
vue de perspective (-p), éventuellement ajouter /zmin/zmax. En cas de vue en perspective
(-p), une plage z (zmin, zmax) peut être ajouté pour indiquer la troisième dimension. Cette
doit être fait uniquement lors de l'utilisation du -Jz option, pas lorsque vous utilisez uniquement l'option -p option.
Dans ce dernier cas, une vue en perspective de l'avion est tracée, sans troisième
dimension. Pour les données cartésiennes, donnez simplement xmin/xmax/ymin/ymax. Cette option fonde la
statistiques sur les COE qui relèvent du domaine spécifié.

-V[niveau] (plus ...)
Sélectionnez le niveau de verbosité [c].

-Poids|décart
Donner t or d et ajoutez l'intervalle de temps maximal correspondant (en unités utilisateur ; c'est
généralement secondes [Infini]), ou distance (pour les unités, voir ) écart [Infini])
autorisée entre les deux points de données immédiatement de part et d'autre d'un croisement. Si
ces limites sont dépassées, un manque de données est alors supposé et aucun COE ne sera déterminé.

-^ or juste -
Imprime un court message sur la syntaxe de la commande, puis quitte (REMARQUE : sous Windows
utiliser juste -).

-+ or juste +
Imprimez un message d'utilisation détaillé (aide), y compris l'explication de tout
option spécifique au module (mais pas les options communes GMT), puis se ferme.

-? or aucune arguments
Imprimez un message d'utilisation (aide) complet, y compris l'explication des options, puis
sorties.

--version
Imprimer la version GMT et quitter.

--show-datadir
Affichez le chemin complet vers le répertoire de partage GMT et quittez.

DÉFINITION DES DOSSIERS

Ces fichiers *.def contiennent des informations sur le format du fichier de données et comportent deux sections :
(1) informations d'en-tête et (2) informations de colonne. Toutes les informations d'en-tête commencent par
caractère # dans la première colonne, immédiatement suivi d'une directive en majuscule. Si le
La directive prend un argument séparé par un espace. Vous pouvez ajouter un # à la fin.
commentaires. Cinq directives sont reconnues :

ASCII indique que les fichiers de données sont au format ASCII.

BINARY indique que les fichiers de données sont des fichiers binaires natifs.

NETCDF indique que les fichiers de données sont des fichiers netCDF 1-D compatibles COARDS.

SKIP prend un argument entier qui est soit le nombre de lignes à sauter (lors de la lecture
Fichiers ASCII) ou nombre d'octets à ignorer (lors de la lecture de fichiers binaires natifs). Non utilisé.
avec des fichiers netCDF.

GEO indique que ces fichiers sont des ensembles de données géographiques, avec des périodicités dans le
x-coordonnées (longitudes). Alternativement, utilisez -G.

MULTISEG signifie que chaque piste est composée de plusieurs segments séparés par un en-tête de segment GMT
(alternativement, utiliser -m lors de la définition du TAG système. Non utilisé avec les fichiers netCDF.

Les informations de colonne se composent d'une ligne par colonne dans l'ordre dans lequel les colonnes apparaissent
Le fichier de données. Pour chaque colonne, vous devez fournir sept attributs :

prénom type NaN Proxy NaN en échelon compenser format

prénom est le nom de la variable de colonne. Il est prévu que vous utilisiez la variable spéciale
noms lon (ou x si cartésien) et lat (ou y) pour les deux colonnes de coordonnées requises, et
Paisible lorsque des données de temps facultatives sont présentes.

type est toujours a pour les représentations ASCII des nombres, alors que pour les fichiers binaires, vous pouvez
choisir parmi c pour le caractère signé de 1 octet (-127, +128), u pour l'octet non signé (0-255), h pour
entiers signés sur 2 octets (-32768, +32767), i pour les entiers signés de 4 octets
(-2 147 483 648, +2 147 483 647), f pour les virgules flottantes de 4 octets et d pour un double de 8 octets
virgules flottantes de précision. Pour netCDF, utilisez simplement d car netCDF gérera automatiquement
conversions de types pendant la lecture.

NaN est Y si certaines valeurs (par exemple, -9999) doivent être remplacées par NAN, et N sinon.

Proxy NaN est-ce une valeur spéciale (par exemple, -9999).

en échelon est utilisé pour multiplier les données après la lecture.

compenser est utilisé pour ajouter aux données mises à l'échelle.

format est une chaîne de format de style C utilisée pour imprimer les valeurs de cette colonne.

Si vous donnez - comme le format alors le système de formatage GMT sera utilisé à la place (c'est-à-dire,
FORMAT_FLOAT_OUT, FORMAT_GEO_MAP, FORMAT_DATE_MAP, FORMAT_CLOCK_MAP). Certains formats de fichiers
Il existe déjà des fichiers de définition pré-créés. Parmi ceux-ci, on trouve mgd77 (pour les données MGD77 en ASCII brut)
fichiers), mgd77+ (pour les fichiers netCDF MGD77+ améliorés), gmt (pour l'ancien binaire supplémentaire mgg
fichiers), xy (pour les tables ASCII x, y simples), xyz (idem, avec une colonne z), geo (pour les tables ASCII simples
fichiers ASCII de longitude et de latitude) et geoz (identique, avec une colonne z).

EXEMPLES

Si vous disposez d'un grand ensemble de fichiers de données de piste, vous pouvez les organiser à l'aide des outils x2sys.
Nous allons décrire ici les étapes. Supposons que le format de votre fichier de données de piste soit le suivant :
2 enregistrements d'en-tête avec des informations textuelles suivies d'un nombre quelconque de données au format identique
enregistrements de données avec 6 colonnes (lat, lon, time, obs1, obs2, obs3) et ces fichiers sont appelés
*.trk. Nous appellerons cela le format « ligne ». Commençons par créer le fichier line.def :

┌───────────────┬─────────────┬───────────┬─────────┬───────────┐
│# Définir │ │ │ │ │ │ │
│fichier pour le │ │ │ │ │ │ │
│format de ligne │ │ │ │ │ │ │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│# SAUTER 2 │ # Sauter 2 │ │ │ │ │ │
│ │ en-tête │ │ │ │ │ │
│ │ enregistrements │ │ │ │ │ │
└───────────────┴─────────────┴───────────┴─────────┴──────────┴────────┘

│# GEO │ # Les données sont │ │ │ │ │ │
│ │ géographique │ │ │ │ │ │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│#nom │ type │ NaN │ NaN-proxy │ échelle │ décalage │ oformat │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│lat │ a │ N │ 0 │ 1 │ 0 │ %9.5f │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│lon │ a │ N │ 0 │ 1 │ 0 │ %10.5f │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│temps │ 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 │
└───────────────┴─────────────┴───────────┴─────────┴──────────┴────────┘

Ensuite, nous créons le TAG et le répertoire TAG avec les bases de données pour ces pistes de ligne
fichiers. En supposant qu'ils contiennent des données géographiques et que nous souhaitions en conserver la trace
distribution à une résolution de 1 x 1 degré, avec des distances en km calculées le long de géodésiques
et avec des vitesses données en nœuds, nous pouvons courir

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

Nous avons sélectionné LINE comme balise x2sys. Lorsque les outils x2sys tentent de lire votre ligne,
fichiers de données, ils chercheront d'abord dans le répertoire courant et ensuite dans le fichier
TAG_paths.txt pour obtenir la liste des répertoires supplémentaires à examiner. Par conséquent, créez un tel fichier
(ici LINE_paths.txt) et y coller les chemins complets vers vos répertoires de données. Tous
Les fichiers liés aux TAG (fichiers de définition, fichiers de balises et bases de données de suivi créés) seront
devrait être dans le répertoire pointé par $X2SYS_HOME/TAG (dans notre cas
$X2SYS_HOME/LINE). Notez que l'argument de -D doit contenir le chemin complet si le *.def
le fichier n'est pas dans le répertoire courant. x2sys_init copiera ce fichier dans le
$X2SYS_HOME/TAG répertoire où tous les autres outils x2sys s'attendront à le trouver.

Créer tbf fichier(s) :
Une fois les bases de données TAG (vides) initialisées, nous procédons à une opération en deux étapes
processus pour les remplir. Nous exécutons d'abord x2sys_binlist sur tous nos fichiers de piste à
créer un (ou plusieurs) fichier(s) d'index de pistes multisegments (tbf). Ceux-ci contiennent
informations sur les bacs de 1 x 1 degré (ou toute autre taille de bloc ; voir -I) chaque piste
a visité et quelles observations (dans votre cas obs1, obs2, obs3) ont été réellement
observés (toutes les traces ne présentent pas forcément les trois types d'observations partout). Pour
Par exemple, si vos pistes sont répertoriées dans le fichier tracks.lis, nous pouvons exécuter cette commande :

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

Mises à jour indice données, base:
Ensuite, les fichiers d'index de piste sont transmis à x2sys_put qui insérera le
informations dans les bases de données TAG :

gmt x2sys_put -V -TLINE pistes.tbf

Rechercher pour données:
Vous pouvez désormais utiliser x2sys_get pour trouver toutes les pistes dans une certaine sous-région, et
limiter éventuellement la recherche aux pistes qui ont une combinaison particulière de
observables. Par exemple, pour trouver toutes les pistes qui contiennent à la fois obs1 et obs3 à l'intérieur
région spécifiée, exécuter

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

MGD77[+] or GMT:
Des fichiers de définition existent déjà pour les fichiers MGD77 (ASCII standard et améliorés)
fichiers MGD77+ basés sur netCDF) et les anciens fichiers *.gmt manipulés par le mgg
suppléments ; pour ces ensembles de données, le -C et -N sera par défaut le grand cercle
calcul de distance en km et de vitesse en m/s. Il existe également des fichiers de définition pour
Traces simples x, y[, z] et lon, lat[, z]. Pour initialiser de nouvelles bases de données de traces à utiliser.
avec les données MGD77 de NGDC, essayez

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

où nous avons choisi un seuil de 15 minutes (900 secondes) ou de 5 km pour indiquer un manque de données
et sélectionnez les nœuds comme vitesse ; les autres étapes sont similaires.

binaire fichiers:
Imaginons que vos fichiers de lignes soient en fait des fichiers binaires de 128 octets.
structure d'en-tête (à ignorer) suivie des enregistrements de données et où lon, lat,
Paisible sont des nombres à double précision tandis que les trois observations sont des entiers de 2 octets
qui doit être multiplié par 0.1. Finalement, les deux premières observations peuvent être -32 768
Cela signifie qu'aucune donnée n'est disponible. Il suffit d'ajouter une ligne.def différente.
fichier:

┌───────────────┬─────────────┬───────────┬─────────┬───────────┐
│# Définir │ │ │ │ │ │ │
│fichier pour le │ │ │ │ │ │ │
│ligne binaire │ │ │ │ │ │ │
│format │ │ │ │ │ │ │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│# BINAIRE │ # Le fichier est │ │ │ │ │ │
│ │ maintenant binaire │ │ │ │ │ │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│# SAUTER 128 │ # Sauter 128 │ │ │ │ │ │
│ │ octets │ │ │ │ │ │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│# GEO │ # Les données sont │ │ │ │ │ │
│ │ géographique │ │ │ │ │ │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│#nom │ type │ NaN │ NaN-proxy │ échelle │ décalage │ oformat │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│lon │ d │ N │ 0 │ 1 │ 0 │ %10.5f │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│lat │ d │ N │ 0 │ 1 │ 0 │ %9.5f │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│temps │ 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 │
└───────────────┴─────────────┴───────────┴─────────┴──────────┴────────┘

Le reste des étapes est identique.

COARDS 1-D netCDF fichiers:
Enfin, supposons que vos fichiers de ligne soient en fait des fichiers netCDF conformes à la
Convention COARDS, avec des colonnes de données nommées lon, lat, Paisible, obs1, obs2et obs3.
Tout ce dont vous avez besoin est un fichier line.def différent :

┌───────────────┬─────────────┬───────────┬─────────┬───────────┐
│# Définir │ │ │ │ │ │ │
│fichier pour le │ │ │ │ │ │ │
│netCDF │ │ │ │ │ │ │
│Ligne COARDS │ │ │ │ │ │ │
│format │ │ │ │ │ │ │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│# NETCDF │ # Le fichier est │ │ │ │ │ │
│ │ maintenant netCDF │ │ │ │ │ │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│# GEO │ # Les données sont │ │ │ │ │ │
│ │ géographique │ │ │ │ │ │
└───────────────┴─────────────┴───────────┴─────────┴──────────┴────────┘

│#nom │ type │ NaN │ NaN-proxy │ échelle │ décalage │ oformat │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│lon │ d │ N │ 0 │ 1 │ 0 │ %10.5f │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│lat │ d │ N │ 0 │ 1 │ 0 │ %9.5f │
├──────────────┼─────────────┼──────────┼────────┼─────────┤
│temps │ 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 │
└───────────────┴─────────────┴───────────┴─────────┴──────────┴────────┘

Notez que nous n'utilisons pas de proxys de mise à l'échelle ou NAN, car ces problèmes sont généralement traités
en interne dans la description du format netCDF.

Utiliser x2sys_initgmt en ligne à l'aide des services onworks.net