mgd77managegmt - En ligne dans le Cloud

PROGRAMME:

Nom

mgd77manage - Gérer le contenu des fichiers MGD77+

SYNOPSIS

mgd77gérer identifiants NGDC [[+]a|c|d|D|e|E|g|i|n|t|Tfileinfo ] [ f|g|e ] [ abrév1,abrév2, ...)
] [ vide ] [ ] [ abrégé/prénom/unité/t/escaliers/compenser/commentaire ] [ unité ] [ région ] [ [niveau]
] [ -bi] [ -du] [ -n]

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

DESCRIPTION

mgd77gérer traite du maintien de colonnes personnalisées supplémentaires dans les fichiers MGD77+ netCDF. Vous pouvez
soit supprimer une ou plusieurs colonnes, ajouter une nouvelle colonne, mettre à jour une colonne existante avec de nouvelles
données ou fournir des informations de correction d'erreur (fichiers *.e77). De nouvelles données peuvent provenir d'un tableau
(ASCII sauf si -bi est utilisé), être basé sur des colonnes existantes et certaines
expressions, ou elles peuvent être obtenues en échantillonnant une grille (choisir entre une grille GMT ou une
Sandwell/Smith Mercator *.img grid) le long de la piste. Les nouvelles données seront ajoutées au
MGD77+ sous la forme d'une colonne de données supplémentaire du type spécifié. Le fichier de données sera
modifié; aucun nouveau fichier ne sera créé. Pour les grands enjeux, voir la section DISCUSSION
ci-dessous.

EST REQUIS ARGUMENTS

identifiants NGDC
Il peut s'agir d'un ou plusieurs des cinq types de spécificateurs :

1. ID NGDC à 8 caractères, par exemple, 01010083, JA010010 etc., etc.

2. 2 caractères codes qui renverront toutes les croisières de chaque agence.

3. 4 caractères codes, qui renverront toutes les croisières de ces
navires.

4. = , où est une table avec des identifiants NGDC, un par ligne.

5. Si rien n'est spécifié, nous retournons toutes les croisières dans la base de données.

(Voir mgd77info -L pour les codes d'agence et de navire). Les extensions ".mgd77" ou ".nc"
sera automatiquement ajouté, si nécessaire (utiliser -I pour ignorer certains types de fichiers).
Les fichiers Cruise seront recherchés en premier dans le répertoire actuel et en second dans tous
répertoires répertoriés dans $MGD77_HOME/mgd77_paths.txt [Si $MGD77_HOME n'est pas réglé
sera par défaut $GMT_SHAREDIR/mgd77].

EN OPTION ARGUMENTS

-A[+]a|c|d|D|e|E|g|i|n|t|Tfileinfo
Ajoutez une nouvelle colonne de données. Si une colonne existante avec la même abréviation déjà
existe dans le fichier, nous refuserons lâchement de mettre à jour le fichier. En précisant -A+
surmonte cette réticence (Cependant, parfois une colonne existante ne peut pas être mise à niveau
sans le supprimer au préalable ; si c'est le cas, vous serez prévenu). Sélectionnez un code source de colonne
parmi a, c, d, D, e, g, i, n, tou T; descriptions détaillées pour chaque choix
suivre:

a Ajoutez le nom de fichier d'une table à une seule colonne à ajouter. Le fichier doit avoir le même numéro
de lignes en tant que fichier MGD77+. Si aucun fichier n'est fourni, nous lisons à partir de stdin à la place.

c Créer une nouvelle colonne qui dérive de données ou de formules existantes pour les corrections
et les champs de référence. Ajouter c pour les corrections Carter soustraites de
profondeurs non corrigées, g pour le champ de référence de gravité IGF (alias "gravité normale"),
m pour le champ de référence magnétique du champ total IGRF, et r pour magnétique recalculé
anomalie (ajouter 1 ou 2 pour spécifier quelle colonne de champ total utiliser [1]). Pour la gravité
nous choisissons le champ de référence en fonction du paramètre Gravity Theoretical Formula
Code dans l'en-tête MGD77 de la croisière. Si cela n'est pas défini ou n'est pas valide, nous allons par défaut
l'IGF 1980. Vous pouvez outrepasser ce comportement en ajoutant le code souhaité : 1 =
Heiskanen 1924, 2 = International 1930, 3 = IGF1967 ou 4 = IGF1980.

d Ajouter le nom de fichier d'un tableau à deux colonnes avec la première colonne contenant les distances
le long de la piste et la deuxième colonne contenant les valeurs de données. Si aucun fichier n'est fourni, nous lisons
de stdin à la place. Les enregistrements avec des distances correspondantes dans le fichier MGD77+ seront
attribuer les nouvelles valeurs ; à d'autres distances, nous les réglons sur NaN. Sinon, donnez
haut de casse D à la place et nous interpolerons la colonne à toutes les distances d'enregistrement.
See -N pour choisir les unités de distance et -C pour choisir comment les distances sont
calculé.

e S'attend à trouver un journal d'erreurs/corrections e77 de mgd77 renifleur avec le nom
NGDC_ID.e77 dans le répertoire courant ou dans $MGD77_HOME/E77 ; ce dossier sera examiné
et utilisé pour apporter des modifications aux valeurs d'en-tête, spécifiez un
correction pour certaines colonnes (telles que l'échelle et le décalage), spécifiez qu'un certain
l'anomalie doit être recalculée à partir des observations (par exemple, recalculer le mag à partir de
mtf1 et le dernier IGRF), et ajouter ou mettre à jour la colonne spéciale drapeau qui peut tenir
bitflags (0 = BON, 1 = MAUVAIS) pour chaque champ de données dans l'ensemble de données standard MGD77.
Tous les termes de correction fixes trouvés (comme la nécessité de mettre à l'échelle un champ de 0.1 ou 10
parce que l'agence source a utilisé des unités incorrectes) seront écrites en tant qu'attributs pour
le fichier netCDF MGD77+ et appliqué lors de la lecture des données par liste mgd77. Éphémère
les corrections telles que celles déterminées par analyse croisée ne sont pas conservées dans les données
fichiers mais résident dans des tables de correction (voir liste mgd77 pour les détails). Par défaut, le
le premier caractère de chaque ligne d'en-tête dans le fichier e77 (qui est ?, Y ou N) sera
consulté pour voir si l'ajustement correspondant doit être appliqué. Si seulement
des paramètres indécis sont trouvés (ii, ?), nous abandonnerons et n'apporterons aucun changement. Seul
les enregistrements marqués Y seront traités. Vous pouvez remplacer ce comportement en ajoutant un
ou plusieurs modificateurs au -Ae commander: h ignorera toutes les corrections d'en-tête, f sera
ignorer toutes les corrections de tendance systématiques fixes, n, vet s ignorera les bitflags
concernant la navigation, les valeurs de données et les pentes de données, respectivement. Utilisation -A+e à
remplacer toutes les corrections E77 existantes dans le fichier par les nouvelles valeurs. Enfin, e77
les corrections ne seront pas appliquées si le fichier E77 n'a pas été vérifié. Utilisation -AE à
ignorer l'état de vérification.

g Échantillonner une grille géographique GMT (lon, lat) le long de la piste donnée par le fichier MGD77+
en utilisant l'interpolation bicubique (cependant, voir -n). Ajoutez le nom d'un fichier de grille GMT.

i Échantillonnez une grille Sandwell/Smith Mercator *.img le long de la piste donnée par le MGD77+
en utilisant l'interpolation bicubique (cependant, voir -n). Ajoutez le nom de fichier de la grille img,
suivi de l'échelle de données séparée par des virgules (généralement 1 ou 0.1), le mode de fichier IMG
(0-3), et éventuellement la latitude max de la grille img [80.738]. Les modes représentent le
suivant : (0) fichiers img sans code de contrainte, renvoie des données à tous les points, (1)
Fichier Img avec contraintes codées, données de retour en tout point, (2) Fichier Img avec
contraintes codées, renvoient des données uniquement aux points contraints et NaN ailleurs, et
(3) Fichier img avec contraintes codées, renvoie 1 aux contraintes et 0 ailleurs.

n Ajouter le nom de fichier d'un tableau à deux colonnes avec la première colonne contenant l'enregistrement
nombre (0 à nrows - 1) et la deuxième colonne contenant les valeurs de données. Si aucun fichier n'est
étant donné que nous lisons à partir de stdin à la place. Enregistrements avec des numéros d'enregistrement correspondants dans le
Le fichier MGD77+ se verra attribuer les nouvelles valeurs ; à d'autres enregistrements, nous les avons mis à NaN.

t Ajouter le nom de fichier d'un tableau à deux colonnes avec la première colonne contenant l'absolu
fois le long de la piste et la deuxième colonne contenant les valeurs de données. Si aucun fichier n'est fourni, nous
lire à partir de stdin à la place. Les enregistrements avec des temps correspondants dans le fichier MGD77+ seront
attribuer les nouvelles valeurs ; à d'autres moments, nous les réglons sur NaN. Sinon, donnez
haut de casse T à la place et nous interpolerons la colonne à tous les instants d'enregistrement.

-Cf|g|e
Ajouter un code à une lettre pour sélectionner la procédure pour la distance le long de la piste
calcul lors de l'utilisation -Un d|D (voir -N pour sélectionner les unités de distance) :

f Distances de la Terre plate.

g Distances orthodromiques [Par défaut].

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

-Dabrév1,abrév2, ...)
Donnez une liste séparée par des virgules des abréviations de colonnes que vous souhaitez supprimer
les fichiers MGD77+. N'utilisez PAS cette option pour supprimer les colonnes que vous remplacez
avec de nouvelles données (utiliser -A+ au lieu). Parce que nous ne pouvons pas supprimer les variables de netCDF
fichiers, nous devons créer un nouveau fichier sans les colonnes à supprimer. Une fois le fichier
créé avec succès, nous renommons temporairement l'ancien fichier, changeons le nouveau nom de fichier en
l'ancien nom de fichier et enfin supprimer l'ancien fichier renommé.

-Evide
Donnez un seul caractère qui sera répété pour remplir les valeurs de chaîne vides, par exemple,
"9" produira une chaîne comme "99999..." [9].

-F Mode forcé. Lorsque ce mode est actif, vous êtes autorisé à supprimer ou à remplacer même
le jeu de colonnes standard MGD77. Tu ferais mieux de savoir ce que tu fais !

-Iabrégé/prénom/unité/ t /escaliers/compenser/commentaire
En plus des informations sur le fichier, nous devons spécifier des informations supplémentaires sur le
colonne supplémentaire. Spécifiez une valeur courte (16 caractères ou moins, en utilisant des lettres minuscules, des chiffres,
ou souligné uniquement) abréviation de la donnée sélectionnée, son nom plus descriptif,
l'unité de données, le code de type de données à 1 caractère (boui, scourt, floot, iNT, ddouble, ou
text) que vous souhaitez utiliser pour le stockage dans le fichier netCDF, toute échelle et tout décalage que nous devrions
appliquer aux données pour les faire entrer dans la plage impliquée par le stockage choisi
type, et un commentaire général (< 128 caractères) sur ce que représentent ces données.
Remarque : Si le type de données texte est sélectionné, les termes « valeurs » dans le -A spirituelle
référez-vous à vos données textuelles. De plus, la discussion sur l'interpolation ne
s'appliquent et la valeur NaN devient une valeur "sans chaîne" (voir -E pour ce que c'est).
Placez des guillemets autour des termes comportant plus d'un mot (par exemple, « Profondeur corrigée »).

-Nunité Ajoutez l'unité de distance (voir UNITÉS). [La valeur par défaut est -Nk (km)]. Uniquement pertinent lorsque
-Ag|i est sélectionné.

-R[unité]x min/xmax/ymin/ymax[r] (plus ...)
Spécifiez la région d'intérêt. Uniquement pertinent lorsque -Ag|i est sélectionné.

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

-bi[ncols][t] (plus ...)
Sélectionnez l'entrée binaire native. Ceci s'applique aux fichiers de données d'entrée à 1 ou 2 colonnes
spécifié sous certains des -A option. L'option d'entrée binaire est uniquement disponible
pour les colonnes de données numériques.

-dupas de données (plus ...)
Remplacer les colonnes d'entrée égales pas de données avec NaN.

-n[b|c|l|n][+a][+bBC][+c][+tпорог] (plus ...)
Sélectionnez le mode d'interpolation pour les grilles.

-^ 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.

UNITÉS

Pour l'unité de distance de la carte, ajoutez unité d pour le degré d'arc, m pour la minute d'arc, et s pour arc
deuxième, ou e pour le compteur [Par défaut], f pour pied, k pour km, M pour mille terrestre, n pour nautique
mille, et u pour pied d'arpentage américain. Par défaut, nous calculons de telles distances en utilisant un
approximation avec les grands cercles. Préfixer - à une distance (ou l'unité est aucune distance n'est
donné) pour effectuer des calculs « Terre plate » (plus rapide mais moins précis) ou ajouter + à
effectuer des calculs géodésiques exacts (plus lents mais plus précis).

CONSÉQUENCES OF GRID RÉÉCHANTILLONNAGE

Le rééchantillonnage ou l'échantillonnage des grilles utilisera divers algorithmes (voir -n) qui peut conduire à
distorsions possibles ou résultats inattendus dans les valeurs rééchantillonnées. Un effet attendu
du rééchantillonnage avec des splines est la tendance des nouvelles valeurs rééchantillonnées à dépasser légèrement
les limites globales min/max de la grille d'origine. Si cela est inacceptable, vous pouvez imposer
écrêtage des valeurs des valeurs rééchantillonnées afin qu'elles ne dépassent pas les valeurs min/max d'entrée de
ajoutant +c à ta -n option.

EXEMPLES

Pour ajouter Geosat/ERS-1 gravité version 11.2 en tant que colonne de données supplémentaire dans les croisières
01010047.nc et 01010008.nc, en stockant les valeurs sous forme de mGal*10 dans un entier court de 2 octets, essayez

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

Pour ajouter une version filtrée de Magnetics en tant que colonne de données supplémentaire de type float pour le
croisière 01010047.nc, et interpoler les données filtrées aux heures données dans le MGD77+
fichier, essayez

gmt mgd77manage 01010047 -ATmymag.tm -Ifiltmag/"Intermediate-wavelength \
résidus magnétiques"/"nTesla"/f/1/0/"Utile pour rechercher des isochrons" -V

Pour supprimer les colonnes supplémentaires existantes satfaa, coastdist et satvgg de tous les fichiers MGD77+,
Essai

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

Pour créer une colonne flottante de 4 octets avec le champ de référence IGRF correct dans tous les fichiers MGD77+,
Essai

gmt mgd77manage =allmgd77.lis -Acm -Iigrf/"référence IGRF \
field"/"nTesla"/f/1/0/"IGRF version 10 pour 1990-2010" -V

DISCUSSION

1. Préambule

Le supplément mgd77 est une tentative pour (1) améliorer la fonctionnalité limitée du
supplément mgg existant, (2) incorporer certaines des idées du supplément gmt+ de Scripps
en autorisant des colonnes de données supplémentaires, et (3) ajouter de nouvelles capacités pour la gestion marine
les données géophysiques des voies stockées dans un CF-1.0- et indépendant de l'architecture
Format de fichier netCDF compatible COARDS. Voici quelques-unes des idées sous-jacentes et des étapes que vous
devez prendre pour maintenir vos fichiers.

2. Introduction

Notre point de départ est les fichiers de données MGD77 ASCII distribués depuis NGDC sur CD-ROMS,
DVD-ROMS et via FTP. En utilisant Geodas pour installer les fichiers localement, nous choisissons le "Carter
"profondeur corrigée" option qui remplira la colonne de profondeur en utilisant les temps de trajet dans les deux sens
et les tables Carter si twt est présent. Cette étape produit environ 5000 fichiers de croisière individuels.
Placez-les dans un ou plusieurs sous-répertoires de votre choix, listez ces sous-répertoires (un
par ligne) dans le fichier mgd77_paths.txt, et placez ce fichier dans le répertoire pointé par
$MGD77_HOME; sinon, définissez cette variable par défaut sur $GMT_SHAREDIR/mgd77.

3. Conversion

Convertissez les fichiers ASCII MGD77 au nouveau format netCDF MGD77+ en utilisant mgd77convertir.
Typiquement, vous ferez une liste de toutes les croisières à convertir (avec ou sans
extension), et vous exécutez ensuite
mgd77convert =cruises.lis -Fa -Tc -V -Lwe+ > log.txt

Les paramètres détaillés garantiront que tous les problèmes détectés lors de la conversion seront
signalé. Les nouveaux fichiers *.nc peuvent également être placés dans un ou plusieurs sous-répertoires séparés
et ceux-ci devraient également être répertoriés dans le fichier mgd77_paths.txt. Nous vous suggérons de placer le
répertoires avec les fichiers *.nc avant les répertoires *.mgd77. Quand vous voulez plus tard limiter
une recherche dans les fichiers d'une certaine extension, vous devez utiliser le -I option.

4. L'ajout de neufs colonnes

mgd77gérer vous permettra d'ajouter des colonnes de données supplémentaires à vos fichiers *.nc. Ceux-ci peuvent être
quoi que ce soit, y compris des chaînes de texte, mais il s'agit très probablement de valeurs numériques échantillonnées le long de la
piste à partir d'une grille fournie ou d'une colonne existante qui ont été filtrés ou manipulés
dans un but particulier. Le format prend en charge jusqu'à 32 colonnes supplémentaires de ce type. Voir cet homme
page pour savoir comment ajouter des colonnes. Vous pouvez ultérieurement décider de supprimer certaines de ces colonnes ou
mettre à jour les données associées à une certaine colonne. Des outils d'extraction de données tels que liste mgd77
peut être utilisé pour extraire un mélange de colonnes MGD77 standard (navigation, temps et l'habituel
observations géophysiques) et vos colonnes personnalisées.

5. Erreur sources

Avant de discuter de la façon de corriger les erreurs, nous allons d'abord énumérer les différentes classes d'erreurs
associés aux données MGD77 : (1) Des erreurs d'enregistrement d'en-tête se produisent lorsque certaines des informations
les champs de l'en-tête ne sont pas conformes à la spécification MGD77 ou les informations requises sont
manquant. mgd77convertir listera ces erreurs lorsque le paramètre détaillé étendu est
choisi. Ces erreurs n'affectent généralement pas les données et sont plutôt des erreurs dans le
métadonnées (2). Des erreurs systématiques corrigées se produisent lorsqu'une colonne de données particulière, malgré la
spécification MGD77, a été encodé de manière incorrecte. Cela signifie généralement que les données seront désactivées
par un facteur constant tel que 10 ou 0.1, voire dans certains cas 1.8288 qui convertit
brasses en mètres. (3) Des erreurs systématiques inconnues se produisent lorsque l'instrument qui a enregistré
les données ou les traitements qui ont suivi ont introduit des signaux qui semblent systématiques
fonctions du temps le long de la trajectoire, de la latitude, du cap ou d'une autre combinaison de termes qui
avoir une explication physique ou logique. Ces termes peuvent parfois être résolus par des données
techniques d'analyse telles que les enquêtes longitudinales et transversales, et il en résultera
en termes de correction qui, lorsqu'ils sont appliqués aux données, supprimeront ces signaux indésirables dans un
manière optimale. Étant donné que ces termes de correction peuvent changer lorsque de nouvelles données sont prises en compte dans
leur détermination, ces corrections sont considérées comme éphémères. (4) Données individuelles
des points ou des séquences de données peuvent enfreindre des règles telles qu'être en dehors des plages possibles ou
d'autres manières violent la raison. De plus, des séquences de points qui peuvent être dans des limites valides
les plages peuvent donner lieu à des gradients de données déraisonnables. Le statut de chaque point
peut donc être déterminé et cela donne lieu à des bitflags BON ou MAUVAIS. Notre politique est
que les sources d'erreur 1, 2 et 4 seront corrigées en fournissant les informations sous forme de métadonnées
dans les fichiers *.nc concernés, tandis que les corrections de la source d'erreur 3 (car elles
constamment amélioré) sera conservé dans une liste de corrections distincte.

6. Trouver erreurs

La mgd77 renifleur est un outil qui effectue une vérification approfondie de l'intégrité de l'original
MGD77 ASCII et génère un journal d'erreurs *.e77 correspondant. Tous les problèmes trouvés sont
codées dans le journal des erreurs, et des termes de correction fixes recommandés sont fournis, si nécessaire. Un
l'analyste peut vérifier que les corrections suggérées sont bien valides (nous voulons seulement
corriger les erreurs d'unité vraiment évidentes), éditer ces journaux d'erreurs et modifier ces termes de correction
et activez-les en changeant le code clé correspondant (voir mgd77 renifleur pour plus de détails).
mgd77gérer peut ingérer ces journaux d'erreurs et (1) corriger les mauvais enregistrements d'en-tête étant donné le
suggestions dans le journal, (2) insérer les termes de correction d'échelle/de décalage à utiliser lors de la lecture
certaines colonnes, et (3) insérer tous les indicateurs binaires trouvés. Réexécutez cette étape si vous trouvez plus tard
d'autres problèmes car tous les paramètres ou indicateurs E77 seront recréés sur la base du dernier journal E77.

7. Erreur corrections

Le programme d'extraction liste mgd77 permet d'appliquer des corrections à la volée lorsque les données
sont demandés. Premièrement, les données avec des indicateurs binaires BAD sont supprimées. Deuxièmement, les données avec
les termes de correction systématique sont corrigés en conséquence. Troisièmement, les données éphémères
les termes de correction auront ces corrections appliquées (si une table de correction est fournie).
Toutes ces étapes nécessitent la présence des métadonnées pertinentes et toutes peuvent être annulées
par l'utilisateur. De plus, les utilisateurs peuvent ajouter leurs propres bitflags en tant que colonnes de données séparées et
utilisé liste mgd77Les tests logiques de pour dicter davantage quelles données sont supprimées de la sortie.

CRÉDITS

Les calculs IGRF sont basés sur un programme Fortran écrit par Susan Macmillan, britannique
Geological Survey, traduit en C via f2c par Joaquim Luis, et adapté au style GMT par
Paul Wessel.

Utilisez mgd77managegmt en ligne en utilisant les services onworks.net