mincdump - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

mincdump - Minc-Dateien in ASCII-Form (CDL) konvertieren

ZUSAMMENFASSUNG

Mincdump [-c] [-h] [-v var1,...] [-B lang] [-F lang] [-l len] [-N Name] [-P
f_Ziffern[,d_Ziffern]] Datei

BESCHREIBUNG

Mincdump basiert auf dem netCDF-Tool ncdump, modifiziert, um sowohl mit MINC 1 (netCDF) zu arbeiten
und MINC 2 (HDF5)-Formatdateien. Es ist hauptsächlich für die Verwendung mit Skripten wie z
mincdiff und Mincheader. Da es nicht am Montreal Neurological Institute erstellt wurde
es folgt nicht den üblichen Konventionen für MINC-Programme.

Mincdump generiert eine ASCII-Darstellung einer angegebenen minc-Datei auf der Standardausgabe.
Die ASCII-Darstellung ist in einer Form namens CDL (``network Common Data form Language'')
die angezeigt, bearbeitet oder als Eingabe für . dienen können ncgen. ncgen ist ein Begleitprogramm, das
kann eine binäre minc-Datei aus einer CDL-Datei generieren. Somit ncgen und Mincdump können als
invertiert, um die Datendarstellung zwischen Binär- und ASCII-Darstellung umzuwandeln.
See ncgen für eine Beschreibung der CDL- und netCDF-Darstellungen.

Mincdump definiert ein Standardformat, das für jeden Typ von netCDF-Daten verwendet wird, dies kann jedoch sein
geändert, wenn ein Attribut `C_format' für eine netCDF-Variable definiert ist. In diesem Fall,
Mincdump verwendet das Attribut `C_format', um jeden Wert zu formatieren. Zum Beispiel, wenn
Gleitkommadaten für die netCDF-Variable `Z' sind bekanntermaßen nur auf drei genau
signifikanten Ziffern, wäre es angebracht, das variable Attribut zu verwenden

Z:C_format = "%.3g"

Mincdump kann auch als einfacher Browser für netCDF-Dateien verwendet werden, um die
Dimensionsnamen und -größen; Variablennamen, -typen und -formen; Attributnamen und -werte;
und optional die Datenwerte für alle Variablen oder ausgewählte Variablen in einer netCDF
Datei.

Mincdump verwendet `_', um Datenwerte darzustellen, die dem `_FillValue'-Attribut entsprechen
für eine Variable, die Daten darstellen soll, die noch nicht geschrieben wurden. Wenn eine Variable
kein `_FillValue'-Attribut hat, wird der Standardfüllwert für den Variablentyp verwendet, wenn die
Variable ist nicht vom Byte-Typ.

OPTIONAL

-c Zeigen Sie die Werte von an Koordinate Variablen (Variablen, die auch Dimensionen sind) als
sowie die Deklarationen aller Dimensionen, Variablen und Attributwerte. Daten
Werte von nicht-koordinierten Variablen werden nicht in die Ausgabe aufgenommen. Dies ist das
die am besten geeignete Option für einen kurzen Einblick in den Aufbau und den Inhalt von a
netCDF-Datei.

-h Nur die anzeigen Kopfzeile Informationen in der Ausgabe, das sind die Deklarationen von
Dimensionen, Variablen und Attribute, aber keine Datenwerte für Variablen. Die
Die Ausgabe ist identisch mit der Verwendung des -c Option, außer dass die Werte der Koordinate
Variablen sind nicht enthalten. (Höchstens einer von -c or -h Optionen können vorhanden sein.)

-v var1,...,varn
Die Ausgabe enthält Datenwerte für die angegebenen Variablen zusätzlich zu den
Deklarationen aller Dimensionen, Variablen und Attribute. Eine oder mehrere Variablen
muss namentlich in der durch Kommas getrennten Liste nach dieser Option angegeben werden. Die
list muss ein einzelnes Argument für den Befehl sein und darf daher keine Leerzeichen oder andere enthalten
Leerzeichen. Bei den genannten Variablen muss es sich um gültige netCDF-Variablen im
Eingabedatei. Die Standardeinstellung, ohne diese Option und in Ermangelung der -c or -h
Optionen, ist das Einschließen von Datenwerten für alle Variablen in der Ausgabe.

-b lang
Eine kurze Anmerkung in Form eines CDL-Kommentars (Text beginnt mit den Zeichen
``//'') wird in den Datenabschnitt der Ausgabe für jede `Zeile' von Daten eingefügt,
um Datenwerte für mehrdimensionale Variablen zu identifizieren. Wenn lang beginnt mit
`C' oder `c', dann werden C-Sprachkonventionen verwendet (nullbasierte Indizes, letzte
Abmessung am schnellsten ändern). Wenn lang beginnt mit `F' oder `f', dann Fortran-Sprache
Konventionen verwendet werden (einsbasierte Indizes, die erste Dimension variiert am schnellsten). In
In beiden Fällen werden die Daten in der gleichen Reihenfolge angezeigt; nur die Anmerkungen
wird abweichen. Diese Option ist nützlich, um durch große Mengen von
mehrdimensionale Daten.

-f lang
Vollständige Anmerkungen in Form von nachgestellten CDL-Kommentaren (Text beginnt mit dem
Zeichen ``//'') für jeden Datenwert (außer einzelne Zeichen in Zeichen
Arrays) werden in den Datenabschnitt aufgenommen. Wenn lang beginnt mit `C' oder `c', dann
C-Sprachkonventionen werden verwendet (nullbasierte Indizes, letzte Dimension variiert
am schnellsten). Wenn lang beginnt mit `F' oder `f', dann werden die Fortran-Sprachkonventionen
verwendet werden (einsbasierte Indizes, erste Dimension variiert am schnellsten). In jedem Fall ist die
Daten werden in der gleichen Reihenfolge angezeigt; nur die Anmerkungen unterscheiden sich. Dies
Option kann nützlich sein, um Daten in andere Filter zu leiten, da jeder Datenwert
erscheint in einer separaten Zeile, vollständig identifiziert.

-l len Ändert die standardmäßige maximale Zeilenlänge (80), die beim Formatieren von Listen von Nicht-
Zeichendatenwerte.

-n Name
CDL erfordert einen Namen für einen netCDF-Datensatz zur Verwendung durch ncgen -b bei der Erzeugung von a
Standardname der netCDF-Datei. Standardmäßig, Mincdump konstruiert diesen Namen aus dem letzten
Bestandteil des Pfadnamens der Eingabe-NetCDF-Datei durch Entfernen einer beliebigen Erweiterung
es hat. Verwenden Sie die -n Option, um einen anderen Namen anzugeben. Obwohl die Ausgabedatei
Name verwendet von ncgen -b angegeben werden kann, kann es ratsam sein, zu haben Mincdump ändern die
Standardname, um ein versehentliches Überschreiben einer wertvollen netCDF-Datei bei der Verwendung zu vermeiden
Mincdump, Bearbeiten der resultierenden CDL-Datei und Verwenden von ncgen -b ein neues generieren
netCDF-Datei aus der bearbeiteten CDL-Datei.

-p float_digits[,double_digits]
Gibt die Standardgenauigkeit (Anzahl signifikanter Stellen) für die Anzeige an
Gleitkomma- oder Datenwerte mit doppelter Genauigkeit für Attribute und Variablen. Wenn
angegeben, überschreibt dieser Wert den Wert des Attributs `C_format' für alle
Variable, die ein solches Attribut hat. Gleitkommadaten werden mit . angezeigt
float_digits wichtige Ziffer. Wenn zweistellig ist ebenfalls angegeben, Doppel-
Präzisionswerte werden mit so vielen signifikanten Stellen angezeigt. In dem
Abwesenheit von irgendwelchen -p Spezifikationen, Gleitkomma- und Daten mit doppelter Genauigkeit sind
mit 7 bzw. 15 signifikanten Stellen angezeigt. CDL-Dateien können erstellt werden
kleiner, wenn weniger Präzision erforderlich ist. Wenn sowohl Gleitkomma- als auch Doppelpräzision
Genauigkeiten angegeben werden, müssen die beiden Werte durch ein Komma getrennt erscheinen (no
Leerzeichen) als einzelnes Argument für den Befehl. Wenn du wirklich jeden letzten Bissen willst
Genauigkeit aus der in der CDL-Datei dargestellten netCDF-Datei für alle möglichen
Gleitkommawerte, müssen Sie dies mit angeben -p 9,17 (gemäß
Satz 15 der unter LITERATUR aufgeführten Arbeit).

Beispiele:

Sehen Sie sich die Struktur der Daten in der netCDF-Datei an `foo.mnc':

mincdump -c foo.mnc

Erstellen Sie eine annotierte CDL-Version der Struktur und der Daten in der netCDF-Datei `foo.mnc',
Verwenden der Indizierung im C-Stil für die Anmerkungen:

mincdump -bc foo.mnc > foo.cdl

Ausgabedaten nur für die Variablen `uwind' und `vwind' aus der netCDF-Datei `foo.mnc', und
Zeigen Sie die Gleitkommadaten mit nur drei signifikanten Stellen der Genauigkeit an:

mincdump -v uwind,vwind -p 3 foo.mnc

Erstellen Sie eine vollständig kommentierte (ein Datenwert pro Zeile) Auflistung der Daten für die Variable
`omega', Verwendung von Fortran-Konventionen für Indizes und Änderung des netCDF-Dataset-Namens in
die resultierende CDL-Datei in `omega':

mincdump -v omega -f fortran -n omega foo.mnc > Z.cdl

Verwenden Sie mincdump online mit den onworks.net-Diensten