mincgen - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

mincgen - Generieren Sie eine MINC-Datei aus einer CDL-Datei.

ZUSAMMENFASSUNG

mincgen [-b] [-n] [-o minc_Dateiname] Eingabedatei

BESCHREIBUNG

mincgen erzeugt eine MINC-Datei. Die Eingabe zu mincgen ist eine Beschreibung einer MINC-Datei in a
kleine Sprache, bekannt als CDL (Network Common Data Form Language), die unten beschrieben wird. Wenn nein
Optionen werden beim Aufruf angegeben mincgen, es prüft lediglich die Syntax der Eingabe-CDL
Datei und erzeugt Fehlermeldungen für alle Verletzungen der CDL-Syntax. Andere Optionen können sein
verwendet, um die entsprechende MINC-Datei zu erstellen.

mincgen kann mit dem Begleitprogramm verwendet werden Mincdump einige einfache Operationen ausführen
auf MINC-Dateien. Um beispielsweise eine Dimension in einer MINC-Datei umzubenennen, verwenden Sie Mincdump erhalten ein
CDL-Version der MINC-Datei, bearbeiten Sie die CDL-Datei, um den Namen der Dimensionen zu ändern, und
- mincgen um aus der bearbeiteten CDL-Datei die entsprechende MINC-Datei zu generieren.

OPTIONAL

-b Erstellen Sie eine (binäre) MINC-Datei. Wenn die -o Option fehlt, wird ein Standarddateiname verwendet
aus dem MINC-Namen aufgebaut werden (angegeben nach dem netcdf or hdf5 Schlüsselwort in
die Eingabe) durch Anhängen der Erweiterung `.mnc'. Existiert bereits eine Datei mit dem
angegebenen Namen, wird er überschrieben.

-o minc_Dateiname
Name für die erstellte binäre MINC-Datei. Wenn diese Option angegeben ist, bedeutet dies, dass
"-b" Option. (Diese Option ist erforderlich, da MINC-Dateien nicht geschrieben werden können
direkt zur Standardausgabe, da die Standardausgabe nicht durchsuchbar ist.)

Beispiele:

Überprüfen Sie die Syntax der CDL-Datei `foo.cdl':

mincgen foo.cdl

Aus der CDL-Datei `foo.cdl', generieren Sie eine äquivalente binäre MINC-Datei mit dem Namen `x.mnc':

mincgen -o x.mnc foo.cdl

ANWENDUNG

CDL Syntax Zusammenfassung
Unten ist ein Beispiel für die CDL-Syntax, das eine MINC-Datei mit mehreren benannten Dimensionen beschreibt
(xspace, yspace und zspace), Variablen (zspace, image), variable Attribute (valid_range,
Zeichentyp) und einige Daten. CDL-Schlüsselwörter sind fett gedruckt. (Dieses Beispiel soll
die Syntax veranschaulichen; eine echte CDL-Datei hätte einen vollständigeren Satz von Attributen, also
dass die Daten vollständiger selbsterklärend wären.)

netcdf foo { // eine beispielhafte MINC-Spezifikation in CDL

Größe:
xspace = 8;
yspace = 8;
zspace = 5;

Variablen:
schweben xLeerzeichen;
schweben yspace;
schweben zspace(zspace);
kurz Bild (zspace, yspace, xspace);
doppelt image-min(zspace)
doppelt image-max(zspace)

// variable Attribute
image:valid_range = 0,5;
technische Daten:
image-min = -1,-1,-1,-1,-1;
Bildmax = 1,1,1,1,1;
Bild =
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,
1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,
2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,
2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,
5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,
5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5;
zspace = 0,2,3.5,7,10;
}

Alle CDL-Anweisungen werden mit einem Semikolon abgeschlossen. Leerzeichen, Tabulatoren und Zeilenumbrüche können verwendet werden
frei zur Lesbarkeit. Kommentare können in jeder Zeile auf die Zeichen `//' folgen.

Eine CDL-Beschreibung besteht aus drei optionalen Teilen: Größe, Variablen und technische Daten,
beginnend mit dem Stichwort Abmessungen:, Variablen: und technische Daten, bzw. Die Variable
Teil kann enthalten Variable Erklärungen und Attribut Zuordnungen.

EIN MINC Dimension wird verwendet, um die Form eines oder mehrerer der mehrdimensionalen
Variablen, die in der MINC-Datei enthalten sind. Eine MINC-Dimension hat einen Namen, eine Größe und möglicherweise
einige andere Attribute.

A Variable stellt ein mehrdimensionales Array von Werten desselben Typs dar. Eine Variable hat
einen Namen, einen Datentyp und eine Form, die durch ihre Dimensionsliste beschrieben wird. Jede Variable kann
auch verbunden haben Attribute (siehe unten) sowie Datenwerte. Name, Datentyp,
und Form einer Variablen werden durch ihre Deklaration im Variable Abschnitt einer CDL
Bezeichnung. Eine Variable kann denselben Namen wie eine Dimension haben; nach Konvention wie
Variable ist eindimensional und enthält Koordinaten der Dimension, die sie benennt.
Dimensionen müssen keine entsprechenden Variablen haben.

Eine netCDF Attribut enthält Informationen über eine netCDF-Variable oder über die gesamte netCDF
Datensatz. Attribute werden verwendet, um solche Eigenschaften wie Einheiten, Sonderwerte, Maximum anzugeben
und gültige Mindestwerte, Skalierungsfaktoren, Offsets und Parameter. Attributinformationen
wird durch einzelne Werte oder Arrays von Werten dargestellt. "Einheiten" ist beispielsweise ein Attribut
dargestellt durch ein Zeichenarray wie "celsius". Ein Attribut hat ein zugeordnetes
Variable, ein Name, ein Datentyp, eine Länge und ein Wert. Im Gegensatz zu Variablen, die
für Daten bestimmt, Attribute sind für Metadaten (Daten über Daten) gedacht.

In CDL wird ein Attribut durch eine Variable und einen Attributnamen bezeichnet, getrennt durch `:'. Es
ist möglich zuzuordnen globale Attribute, die keiner Variablen der Datei zugeordnet sind, als a
ganz, indem Sie `:' vor dem Attributnamen verwenden. Der Datentyp eines Attributs in CDL ist
abgeleitet vom Typ des ihm zugewiesenen Werts. Die Länge eines Attributs ist die
Anzahl der ihm zugeordneten Datenwerte oder die Anzahl der Zeichen in der Zeichenkette
ihm zugeordnet. Mehrere Werte werden Nicht-Zeichen-Attributen durch Trennen zugewiesen
die Werte mit Kommas. Alle einem Attribut zugewiesenen Werte müssen vom gleichen Typ sein.

Die Namen für CDL-Dimensionen, -Variablen und -Attribute müssen mit einem alphabetischen . beginnen
Zeichen oder `_', und nachfolgende Zeichen können alphanumerisch oder `_' oder `-' sein.

Das optionale technische Daten Abschnitt einer CDL-Spezifikation ist der Ort, an dem Variablen initialisiert werden können.
Die Syntax einer Initialisierung ist einfach: ein Variablenname, ein Gleichheitszeichen und ein Komma.
abgegrenzte Liste von Konstanten (evtl. durch Leerzeichen, Tabulatoren und Zeilenumbrüche getrennt) beendet
mit Semikolon. Bei mehrdimensionalen Arrays variiert die letzte Dimension am schnellsten. Daher
Für Matrizen wird eher die Zeilenreihenfolge als die Spaltenreihenfolge verwendet. Wenn weniger Werte geliefert werden
als zum Füllen einer Variablen benötigt wird, wird er um einen typabhängigen `Füllwert' erweitert,
die überschrieben werden kann, indem ein Wert für ein Distinguished-Variable-Attribut namens . angegeben wird
`_Füllwert'. Die Konstantentypen müssen nicht mit dem für eine Variable deklarierten Typ übereinstimmen;
Zwang wird durchgeführt, um zum Beispiel ganze Zahlen in Gleitkommazahlen umzuwandeln. Die Konstante `_'
kann verwendet werden, um den Füllwert für eine Variable zu bestimmen.

Primitive Datum Typen
verkohlen Zeichen
Byte 8-Bit-Daten
kurz 16-Bit-Ganzzahlen mit Vorzeichen
lange 32-Bit-Ganzzahlen mit Vorzeichen
int (Synonym zu lange)
schweben IEEE-Gleitkomma mit einfacher Genauigkeit (32 Bit)
echt (Synonym zu schweben)
doppelt IEEE Gleitkomma mit doppelter Genauigkeit (64 Bit)

Außer dem hinzugefügten Datentyp Byte und das Fehlen von ohne Vorzeichen, CDL unterstützt das gleiche
primitive Datentypen als C. Die Namen für die primitiven Datentypen sind reservierte Wörter in
CDL, daher dürfen die Namen von Variablen, Dimensionen und Attributen keine Typnamen sein. In
Deklarationen können Typnamen in Groß- oder Kleinschreibung angegeben werden.

Bytes unterscheiden sich von Zeichen dadurch, dass sie volle acht Datenbits enthalten sollen.
und das Nullbyte hat keine besondere Bedeutung, wie es bei Zeichendaten der Fall ist.

Shorts können Werte zwischen -32768 und 32767 halten.

Longs können Werte zwischen -2147483648 und 2147483647 halten. int und ganze Zahl werden akzeptiert als
synonym für lange in CDL-Deklarationen. Jetzt gibt es Plattformen mit 64-Bit
Darstellungen für C-Longs kann es besser sein, die int Synonym um Verwechslungen zu vermeiden.

Floats können Werte zwischen etwa -3.4+38 und 3.4+38 enthalten. Ihre Außendarstellung ist
als 32-Bit-IEEE-normalisierte Gleitkommazahlen mit einfacher Genauigkeit. echt wird akzeptiert als
synonym für schweben in CDL-Deklarationen.

Doubles können Werte zwischen etwa -1.7+308 und 1.7+308 enthalten. Ihre Außendarstellung
ist als 64-Bit-IEEE-Standard normalisierte Gleitkommazahlen mit doppelter Genauigkeit.

CDL Konstante
Konstanten, die Attributen oder Variablen zugewiesen sind, können von jedem der grundlegenden MINC-Typen sein. Die
Die Syntax für Konstanten ähnelt der C-Syntax, mit der Ausnahme, dass Typsuffixe angehängt werden müssen
Shorts und Floats, um sie von Longs und Doubles zu unterscheiden.

A Byte Konstante wird durch ein einzelnes Zeichen oder eine Escape-Sequenz mit mehreren Zeichen dargestellt
in einfache Anführungszeichen eingeschlossen. Zum Beispiel,
'a' // ASCII 'a'
'\0' // ein Null-Byte
'\n' // ASCII-Neuzeilenzeichen
'\33' // ASCII-Escape-Zeichen (33 Oktal)
'\x2b' // ASCII plus (2b hex)
'\377' // 377 oktal = 255 dezimal, nicht-ASCII

Zeichenkonstanten werden in doppelte Anführungszeichen eingeschlossen. Ein Zeichen-Array kann dargestellt werden
als String in doppelten Anführungszeichen. Die üblichen C-String-Escape-Konventionen werden beachtet.
Zum Beispiel
"a" // ASCII `a'
"Two\nlines\n" // eine 10-stellige Zeichenfolge mit zwei eingebetteten Zeilenumbrüchen
"a bell:\007" // ein String, der eine ASCII-Glocke enthält
Beachten Sie, dass das Zeichenarray "a" in eine einelementige Variable passen würde, da no
ein abschließendes NULL-Zeichen wird angenommen. Ein Nullbyte in einem Zeichenarray ist jedoch
interpretiert als das Ende der signifikanten Zeichen von der Mincdump Programm, folgendes
die C-Konvention. Daher sollte ein NULL-Byte nicht in eine Zeichenkette eingebettet werden
es sei denn am ende: nutze die Byte Datentyp stattdessen für Byte-Arrays, die die Null enthalten
Byte. MINC und CDL haben keinen String-Typ, sondern nur Zeichenarrays mit fester Länge, die möglicherweise
mehrdimensional sein.

kurz Integer-Konstanten sind für die Darstellung von 16-Bit-Größen mit Vorzeichen gedacht. Die Form
einer kurz Konstante ist eine ganzzahlige Konstante mit einem angehängten `s' oder `S'. Wenn eine kurz
Konstante beginnt mit `0', sie wird als oktal interpretiert, außer wenn sie mit `0x' beginnt,
sie wird als hexadezimale Konstante interpretiert. Zum Beispiel:
-2s // ein kurzer -2
0123s // Oktal
0x7ffs //hexadezimal

Lang Integer-Konstanten sind für die Darstellung von 32-Bit-Größen mit Vorzeichen gedacht. Die Form
einer lange Konstante ist eine gewöhnliche ganzzahlige Konstante, obwohl es akzeptabel ist, an . anzuhängen
wahlweise `l' oder `L'. Wenn eine lange Konstante beginnt mit `0', wird als oktal interpretiert,
außer dass, wenn es mit `0x' beginnt, es als hexadezimale Konstante interpretiert wird. Beispiele
gültig lange Konstanten sind:
-2
1234567890L
0123 // Oktal
0x7ff // hexadezimal

Gleitkommakonstanten vom Typ schweben eignen sich zur Darstellung von Gleitkomma
Daten mit etwa sieben signifikanten Stellen Genauigkeit. Die Form von a schweben Konstante ist
dasselbe wie eine C-Gleitkommakonstante mit einem angehängten `f' oder `F'. Zum Beispiel die
Folgende sind alle akzeptabel schweben Konstanten:
-2.0f
3.14159265358979f // wird auf eine geringere Genauigkeit gekürzt
xnumx.f

Gleitkommakonstanten vom Typ doppelt eignen sich zur Darstellung von Gleitkomma
Daten mit etwa sechzehn signifikanten Stellen Genauigkeit. Die Form von a doppelt Konstante ist
das gleiche wie eine C-Gleitkommakonstante. Ein optionales `d' oder `D' kann angehängt werden. Zum
Beispiel die folgenden sind alle akzeptabel doppelt Konstanten:
-2.0
3.141592653589793
1.0e-20
1.d.

Verwenden Sie mincgen online mit den onworks.net-Diensten