x2sys_initgmt - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

x2sys_init - Initialisiert eine neue x2sys-Trackdatenbank

ZUSAMMENFASSUNG

x2sys_init TAG defizieren [ c|f|g|e ] [ Suffix ] [ ] [ d|g ] [ dx[/dy] ] [ d|sEinheit ] [
Region ] [ [Grad des ] ] [ t|dLücke ]

Hinweis: Zwischen dem Optionsflag und den zugehörigen Argumenten ist kein Leerzeichen zulässig.

BESCHREIBUNG

x2sys_init ist der Ausgangspunkt für jeden, der x2sys verwenden möchte; es initialisiert eine Menge von
Datenbanken, die für eine Art von Streckendaten spezifisch sind. Diese Daten, ihre zugehörigen
Datenbanken und Schlüsselparameter erhalten eine Kurzschreibweise, die als x2sys TAG bezeichnet wird. Die
TAG verfolgt Einstellungen wie das Dateiformat, ob die Daten geografisch sind oder nicht,
und die Binning-Auflösung für Track-Indizes. Laufen x2sys_init ist eine Voraussetzung für
Ausführen eines der anderen x2sys-Programme, wie z x2sys_binlist, wodurch ein Rohöl entsteht
Darstellung, wo sich die einzelnen Datenspuren innerhalb der Domäne befinden und welche Beobachtungen sind
erhältlich; diese Informationen dienen als Eingabe für x2sys_put die die Streckendaten aktualisiert
Base. Dann, x2sys_get kann verwendet werden, um herauszufinden, welche Tracks und Daten in einem verfügbar sind
Region gegeben. Mit dieser Liste von Tracks können Sie verwenden x2sys_cross Spur berechnen
Übergänge, verwenden x2sys_report um Crossover-Statistiken zu melden oder x2sys_list herausziehen
ausgewählte Crossover-Informationen, die x2sys_solve können verwenden, um spurspezifische
systematische Korrekturen. Diese Korrekturen können verwendet werden mit x2sys_datalist extrahieren
korrigierte Datenwerte zur Verwendung in nachfolgenden Arbeiten. Weil du laufen kannst x2sys_init Sie sollen
setzen Sie den Umgebungsparameter X2SYS_HOME auf ein Verzeichnis, in dem Sie Schreibrechte haben,
Hier kann x2sys Ihre Einstellungen verfolgen.

ERFORDERLICH ARGUMENTE

TAG Der eindeutige Name dieses Datentyps x2sys TAG.

-Ddefizieren
Definitionsdateipräfix für diesen Datensatz [Weitere Informationen finden Sie unten unter DEFINITIONSDATEIEN
Information]. Geben Sie den vollständigen Pfad an, wenn sich die Datei nicht im aktuellen Verzeichnis befindet.

OPTIONAL ARGUMENTE

-Cc|f|g|e
Wählen Sie das Verfahren für die Berechnung des Streckenabstands, wenn dies von anderen benötigt wird
Programme:

c Kartesische Abstände [Standard, es sei denn -G eingestellt ist].

f Flache Erde Entfernungen.

g Großkreisentfernungen [Standard, wenn -G eingestellt ist].

e Geodätische Entfernungen auf dem aktuellen GMT-Ellipsoid.

-ESuffix
Gibt die Dateierweiterung (Suffix) für diese Datendateien an. Wenn nicht angegeben, verwenden wir die
Definitionsdatei-Präfix als Suffix (siehe -D).

-F Erstellen neuer Dateien erzwingen, wenn alte vorhanden sind [Standard wird abgebrochen, wenn altes TAG
Dateien gefunden].

-G'tt|g Wählt geografische Koordinaten aus. Anhängen d für Diskontinuität an der Dateline (macht
Längengrad von -180 bis + 180) oder g für Diskontinuität bei Greenwich (macht
Längengrad von 0 bis 360 gehen [Standard]). Wenn nicht angegeben, gehen wir davon aus, dass die Daten
Kartesisch.

-Idx[/dy]
x_inkl [und optional y_inkl] ist der Rasterabstand. Anhängen m Minuten anzeigen oder c
um Sekunden für geografische Daten anzugeben. Diese Abstände beziehen sich auf das verwendete Binning
in der Spur-Bin-Index-Datenbank.

-Nd|sEinheit
Legt die Einheiten für Distanz und Geschwindigkeit fest, wenn sie von anderen Programmen angefordert werden. Anhängen
d für Distanz oder s für Geschwindigkeit, dann geben Sie den gewünschten Einheit as c (kartesische userdist
oder userdist/usertime), e (Meter oder m/s), f (Füße oder Füße/s), k (km oder km/h), m
(Meilen oder Meilen/Std.), n (Seemeilen oder Knoten) oder u (Vermessungsfüße oder Vermessung
Fuß/s). [Standard ist -Ndk -Nse (km und m/s) wenn -G eingestellt ist und -Ndc und -Nsc
sonst (kartesische Einheiten)].

-R[Einheit]Westen/Osten/Süden/Norden[/zmin/zmax][R]
Westen, Osten, Süden und Norden Geben Sie die Region von Interesse an, und Sie können angeben
sie in Dezimalgrad oder im Format [+-]dd:mm[:ss.xxx][W|E|S|N]. Anhängen r wenn niedriger
Anstelle von w/e/s/n werden die linken und oberen rechten Kartenkoordinaten angegeben. Die Zwei
Abkürzungen -Rg und -Rd stehen für globale Domäne (0/360 und -180/+180 in Längengrad
jeweils mit -90/+90 Breitengrad). Geben Sie alternativ für die Rastererstellung
RCodelon/lat/nx/ny, Wobei Code ist eine 2-Zeichen-Kombination aus L, C, R (für links,
Mitte oder rechts) und T, M, B für oben, Mitte oder unten. zB BL für unten links.
Dies gibt an, an welchem ​​Punkt einer rechteckigen Region die lon/lat Koordinate bezieht sich
zu, und die Rastermaße nx und ny mit Rasterabständen über -I wird verwendet, um zu erstellen
die entsprechende Region. Geben Sie alternativ den Namen einer vorhandenen Rasterdatei an
und den -R Einstellungen (und ggf. Rasterabstand) werden aus dem Raster kopiert.
Die richtigen -REinheit erwartet projizierte (kartesische) Koordinaten, die mit ausgewählten kompatibel sind -J
und wir projizieren umgekehrt, um die tatsächliche rechteckige geographische Region zu bestimmen. Zum
perspektivische Ansicht (-p), optional anhängen /zmin/zmax. Bei perspektivischer Ansicht
(-p), ein Z-Bereich (zmin, zmax) kann angehängt werden, um die dritte Dimension anzugeben. Dies
muss nur bei Verwendung des -Jz Option, nicht wenn nur die -p .
Im letzteren Fall wird eine perspektivische Ansicht der Ebene ohne Drittel aufgetragen
Abmessungen. Für kartesische Daten einfach angeben xmin/xmax/ymin/ymax. Diese Option basiert auf der
Statistiken zu den COE, die in die angegebene Domäne fallen.

-V[Grad des ] (Mehr ...)
Wählen Sie die Ausführlichkeitsstufe [c].

-Gewicht|dLücke
ABSICHT t or d und hängen Sie die entsprechende maximale Zeitlücke an (in Benutzereinheiten; dies ist
normalerweise Sekunden [Unendlich]) oder Distanz (für Einheiten siehe ) Lücke [Unendlich])
zwischen den beiden Datenpunkten unmittelbar auf beiden Seiten einer Frequenzweiche zulässig. Wenn
werden diese Grenzen überschritten, wird von einer Datenlücke ausgegangen und kein COE ermittelt.

-^ or nur -
Drucken Sie eine kurze Nachricht über die Syntax des Befehls und beenden Sie ihn (HINWEIS: unter Windows
benutze nur -).

-+ or nur +
Drucken Sie eine ausführliche Nutzungs-(Hilfe-)Nachricht, einschließlich der Erläuterungen zu allen
modulspezifische Option (aber nicht die allgemeinen GMT-Optionen), wird dann beendet.

-? or nicht Argumente
Drucken Sie eine vollständige Nutzungs-(Hilfe-)Nachricht, einschließlich der Erklärung der Optionen, dann
Ausgänge.

--Version
GMT-Version drucken und beenden.

--show-datadir
Vollständigen Pfad zum GMT-Freigabeverzeichnis drucken und beenden.

DEFINITION DATEIEN

Diese *.def-Dateien enthalten Informationen zum Datendateiformat und haben zwei Abschnitte:
(1) Kopfzeileninformationen und (2) Spalteninformationen. Alle Header-Informationen beginnen mit dem
Zeichen # in der ersten Spalte, direkt gefolgt von einer Anweisung in Großbuchstaben. Wenn die
Die Direktive nimmt ein Argument an, das durch Leerzeichen getrennt ist. Sie können ein nachgestelltes # anhängen.
Kommentare. Fünf Richtlinien werden anerkannt:

ASCII gibt an, dass die Datendateien im ASCII-Format vorliegen.

BINARY gibt an, dass die Datendateien native Binärdateien sind.

NETCDF gibt an, dass die Datendateien COARDS-konforme 1-D-netCDF-Dateien sind.

SKIP nimmt ein ganzzahliges Argument an, das entweder die Anzahl der zu überspringenden Zeilen ist (beim Lesen
ASCII-Dateien) oder die Anzahl der zu überspringenden Bytes (beim Lesen nativer Binärdateien). Nicht benutzt
mit netCDF-Dateien.

GEO weist darauf hin, dass es sich bei diesen Dateien um geografische Datensätze mit Periodizitäten im
x-Koordinate (Längengrade). Alternativ verwenden Sie -G.

MULTISEG bedeutet, dass jede Spur aus mehreren Segmenten besteht, die durch einen GMT-Segment-Header getrennt sind
(alternativ verwenden Sie -m beim Definieren des System-TAG). Wird nicht mit netCDF-Dateien verwendet.

Die Spalteninformationen bestehen aus einer Zeile pro Spalte in der Reihenfolge, in der die Spalten erscheinen
die Datendatei. Für jede Spalte müssen Sie sieben Attribute angeben:

Name tippe NaN NaN-Proxy Treppe Offset oformat

Name ist der Name der Spaltenvariablen. Es wird erwartet, dass Sie das Special nutzen
Namen lon (oder x wenn kartesisch) und lat (oder y) für die beiden erforderlichen Koordinatenspalten und
Zeit wenn optionale Zeitdaten vorhanden sind.

tippe immer a für ASCII-Darstellungen von Zahlen, während Sie für Binärdateien
wählen Sie aus c für 1-Byte-Zeichen mit Vorzeichen (-127,+128), u für vorzeichenloses Byte (0-255), h für
2-Byte-Ganzzahlen mit Vorzeichen (-32768,+32767), i für vorzeichenbehaftete 4-Byte-Ganzzahlen
(-2,147,483,648,+2,147,483,647), f für 4-Byte-Gleitkomma und d für 8-Byte-Doppel
präzise Gleitkommazahlen. Für netCDF verwenden Sie einfach d wie netCDF automatisch verarbeitet
Typkonvertierungen beim Lesen.

NaN ist Y, wenn bestimmte Werte (zB -9999) durch NAN ersetzt werden sollen, andernfalls N.

NaN-Proxy ist dieser spezielle Wert (zB -9999).

Treppe wird verwendet, um die Daten nach dem Lesen zu multiplizieren.

Offset wird verwendet, um die skalierten Daten hinzuzufügen.

oformat ist eine Formatzeichenfolge im C-Stil, die zum Drucken von Werten aus dieser Spalte verwendet wird.

Wenn du gibst - als die oformat dann wird stattdessen die Formatierungsmaschinerie von GMT verwendet (d. h.,
FORMAT_FLOAT_OUT, FORMAT_GEO_MAP, FORMAT_DATE_MAP, FORMAT_CLOCK_MAP). Einige Dateiformate
haben bereits vorgefertigte Definitionsdateien. Dazu gehören mgd77 (für reine ASCII-MGD77-Daten
Dateien), mgd77+ (für erweiterte MGD77+ netCDF-Dateien), gmt (für alte mgg-Supplement-Binärdateien)
Dateien), xy (für einfache ASCII x, y Tabellen), xyz (gleich, mit einer Z-Spalte), geo (für einfache
ASCII-Längengrad-, Breitengrad-Dateien) und Geoz (gleich, mit einer Z-Spalte).

Beispiele:

Wenn Sie über einen großen Satz von Track-Datendateien verfügen, können Sie diese mit den x2sys-Tools organisieren.
Hier werden wir die Schritte skizzieren. Nehmen wir an, Ihr Track-Datendateiformat besteht aus
2 Header-Datensätze mit Textinformationen gefolgt von beliebig vielen identisch formatierten
Datensätze mit 6 Spalten (lat, lon, time, obs1, obs2, obs3) und diese Dateien werden aufgerufen
*.trk. Wir nennen dies das "Linien"-Format. Zuerst erstellen wir die Datei line.def:

┌─────────────┬──────────────┬─────┬───────────┬── ─────┬────────┬─────────┐
│# Definieren │ │ │ │ │ │ │
│Datei für die │ │ │ │ │ │ │
│Linienformat │ │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│# 2 überspringen │ # 2 überspringen │ │ │ │ │ │
│ │ Kopfzeile │ │ │ │ │ │
│ │ Datensätze │ │ │ │ │ │
└─────────────┴──────────────┴─────┴───────────┴── ─────┴────────┴─────────┘

│# GEO │ # Daten sind │ │ │ │ │ │
│ │ geografisch │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│#name │ Typ │ NaN │ NaN-Proxy │ Maßstab │ Offset │ oformat │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
lat │ a │ N │ 0 │ 1 │ 0 │ %9.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│lon │a │N │ 0 │ 1 │ 0 │ %10.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│Zeit │ 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 │
└─────────────┴──────────────┴─────┴───────────┴── ─────┴────────┴─────────┘

Als nächstes erstellen wir den TAG und das TAG-Verzeichnis mit den Datenbanken für diese Liniengleise
Dateien. Vorausgesetzt, diese enthalten geografische Daten und wir möchten den Überblick über die Daten behalten
Verteilung mit einer Auflösung von 1 x 1 Grad, mit Entfernungen in km, die entlang der Geodäten berechnet wurden
und mit Geschwindigkeiten in Knoten können wir laufen

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

wobei wir LINE als unser x2sys-Tag ausgewählt haben. Wenn x2sys-Tools versuchen, Ihre Zeile zu lesen
Datendateien suchen sie zuerst im aktuellen Verzeichnis und dann in der Datei
TAG_paths.txt für eine Liste zusätzlicher zu untersuchender Verzeichnisse. Erstellen Sie daher z
Datei (hier LINE_paths.txt) und kleben Sie dort die vollständigen Pfade zu Ihren Datenverzeichnissen. Alle
TAG-bezogene Dateien (Definitionsdateien, Tag-Dateien und erstellte Track-Datenbanken) werden
erwartet, dass es sich in dem Verzeichnis befindet, auf das von . verwiesen wird $X2SYS_HOME/TAG (in unserem Fall
$X2SYS_HOME/LEITUNG). Beachten Sie, dass das Argument zu -D muss den vollständigen Pfad enthalten, wenn die *.def
Datei befindet sich nicht im aktuellen Verzeichnis. x2sys_init kopiert diese Datei in die
$X2SYS_HOME/TAG Verzeichnis, in dem alle anderen x2sys-Tools erwarten, es zu finden.

Kreation tbf Datei(en):
Nachdem die (leeren) TAG-Datenbanken initialisiert wurden, durchlaufen wir zwei Schritte
Prozess, um sie zu bevölkern. Zuerst laufen wir x2sys_binlist auf alle unsere Track-Dateien zu
Erstellen Sie eine (oder mehrere) Multisegment-Track-Bin-Index-Dateien (tbf). Diese enthalten
Informationen darüber, welche 1 x 1 Grad Bins (oder jede andere Blockgröße; siehe -I) jede Spur
besucht hat und welche Beobachtungen (in deinem Fall obs1, obs2, obs3) tatsächlich waren
beobachtet (nicht alle Spuren können überall alle drei Arten von Beobachtungen haben). Zum
Wenn Ihre Tracks beispielsweise in der Datei tracks.lis aufgeführt sind, können wir diesen Befehl ausführen:

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

Aktualisierung Index frustrierten Base:
Als nächstes werden die Track-Bin-Indexdateien an x2sys_put das wird die einfügen
Informationen in die TAG-Datenbanken:

gmt x2sys_put -V -TLINE track.tbf

Suche für Daten:
Sie können jetzt verwenden x2sys_get um alle Tracks innerhalb einer bestimmten Unterregion zu finden, und
Beschränken Sie die Suche optional auf die Titel mit einer bestimmten Kombination von
beobachtbare. ZB um alle Tracks zu finden, die sowohl obs1 als auch obs3 enthalten
angegebene Region, Lauf

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

MGD77[+] or GMT:
Definitionsdateien existieren bereits für MGD77-Dateien (sowohl Standard-ASCII als auch erweiterte
netCDF-basierte MGD77+-Dateien) und die alten *.gmt-Dateien, die vom mgg . manipuliert wurden
Ergänzungen; für diese Datensätze die -C und -N wird standardmäßig auf Großkreis eingestellt
Entfernungsberechnung in km und Geschwindigkeit in m/s. Es gibt auch Definitionsdateien für
einfache x,y[,z]- und lon,lat[,z]-Spuren. Um neue Track-Datenbanken zu initiieren, die verwendet werden sollen
mit MGD77-Daten von NGDC versuchen

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

wobei wir einen Schwellenwert von 15 Minuten (900 Sek.) oder 5 km gewählt haben, um eine Datenlücke anzuzeigen
und ausgewählte Knoten als Geschwindigkeit; die anderen Schritte sind ähnlich.

Binär Dateien:
Nehmen wir an, Ihre Zeilendateien sind in Wirklichkeit Binärdateien mit 128 Byte
Header-Struktur (zu überspringen) gefolgt von den Datensätzen und wo lon, lat,
Zeit sind Zahlen mit doppelter Genauigkeit, während die drei Beobachtungen 2-Byte-Ganzzahlen sind
die mit 0.1 multipliziert werden muss. Schließlich können die ersten beiden Beobachtungen -32768 . sein
was bedeutet, dass keine Daten verfügbar sind. Alles, was Sie brauchen, ist eine andere Zeile.def
Datei:

┌─────────────┬──────────────┬─────┬───────────┬── ─────┬────────┬─────────┐
│# Definieren │ │ │ │ │ │ │
│Datei für die │ │ │ │ │ │ │
│Binärleitung │ │ │ │ │ │ │
│formatieren │ │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│# BINÄR │ # Datei ist │ │ │ │ │ │
│ │ jetzt binär │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│# 128 überspringen │ # 128 überspringen │ │ │ │ │ │
│ │ Bytes │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│# GEO │ # Daten sind │ │ │ │ │ │
│ │ geografisch │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│#name │ Typ │ NaN │ NaN-Proxy │ Maßstab │ Offset │ oformat │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│lon │d │N │0 │1 │0 │%10.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
lat │ d │ N │ 0 │ 1 │ 0 │ %9.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│Zeit │ 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 │
└─────────────┴──────────────┴─────┴───────────┴── ─────┴────────┴─────────┘

Die restlichen Schritte sind identisch.

KARTEN 1-D netCDF Dateien:
Angenommen, Ihre Zeilendateien sind tatsächlich netCDF-Dateien, die den
COARDS-Konvention mit Datenspalten namens lon, lat, Zeit, obs1, obs2 und obs3.
Alles, was benötigt wird, ist eine andere line.def-Datei:

┌─────────────┬──────────────┬─────┬───────────┬── ─────┬────────┬─────────┐
│# Definieren │ │ │ │ │ │ │
│Datei für die │ │ │ │ │ │ │
│netCDF │ │ │ │ │ │ │
│COARDS-Linie │ │ │ │ │ │ │
│formatieren │ │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│# NETCDF │ # Datei ist │ │ │ │ │ │
│ │ jetzt netCDF │ │ │ │ │ │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│# GEO │ # Daten sind │ │ │ │ │ │
│ │ geografisch │ │ │ │ │ │
└─────────────┴──────────────┴─────┴───────────┴── ─────┴────────┴─────────┘

│#name │ Typ │ NaN │ NaN-Proxy │ Maßstab │ Offset │ oformat │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│lon │d │N │0 │1 │0 │%10.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
lat │ d │ N │ 0 │ 1 │ 0 │ %9.5f │
├─────────────┼──────────────┼─────┼───────────┼── ─────┼────────┼─────────┤
│Zeit │ 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 │
└─────────────┴──────────────┴─────┴───────────┴── ─────┴────────┴─────────┘

Beachten Sie, dass wir keine Skalierungs- oder NAN-Proxys verwenden, da diese Probleme normalerweise behandelt werden
intern in der netCDF-Formatbeschreibung.

Verwenden Sie x2sys_initgmt online mit den onworks.net-Diensten