mincgen - Online in de cloud

PROGRAMMA:

NAAM

mincgen - Genereer een MINC-bestand van een CDL-bestand.

KORTE INHOUD

mincgen [-b] [-n] [-o minc_bestandsnaam] Invoer bestand

PRODUCTBESCHRIJVING

mingen genereert een MINC-bestand. De invoer voor mingen is een beschrijving van een MINC-bestand in een
kleine taal bekend als CDL (netwerk Common Data form Language), hieronder beschreven. Als Nee
opties worden gespecificeerd in het aanroepen van mingen, het controleert alleen de syntaxis van de invoer CDL
bestand, met foutmeldingen voor eventuele schendingen van de CDL-syntaxis. Andere opties kunnen zijn:
gebruikt om het overeenkomstige MINC-bestand te maken.

mingen kan worden gebruikt met het begeleidende programma minidump om enkele eenvoudige handelingen uit te voeren
op MINC-bestanden. Als u bijvoorbeeld een dimensie in een MINC-bestand wilt hernoemen, gebruikt u minidump een krijgen
CDL-versie van het MINC-bestand, bewerk het CDL-bestand om de naam van de dimensies te wijzigen, en
. mingen om het overeenkomstige MINC-bestand te genereren uit het bewerkte CDL-bestand.

OPTIES

-b Maak een (binair) MINC-bestand aan. Als de -o optie afwezig is, zal er een standaard bestandsnaam zijn
worden opgebouwd uit de MINC-naam (gespecificeerd na de netcdf or hdf5 trefwoord in
de invoer) door de extensie `.mnc' toe te voegen. Als er al een bestand bestaat met de
opgegeven naam, wordt deze overschreven.

-o minc_bestandsnaam
Naam voor het gemaakte binaire MINC-bestand. Als deze optie is opgegeven, betekent dit dat de
"-b" optie. (Deze optie is nodig omdat MINC-bestanden niet kunnen worden geschreven
rechtstreeks naar standaarduitvoer, aangezien standaarduitvoer niet kan worden gezocht.)

Voorbeelden

Controleer de syntaxis van het CDL-bestand `foo.cdl':

mincgen foo.cdl

Van het CDL-bestand `foo.cdl', genereer een gelijkwaardig binair MINC-bestand met de naam `x.mnc':

mincgen -o x.mnc foo.cdl

GEBRUIK

CDL Syntaxis Samengevat
Hieronder ziet u een voorbeeld van de CDL-syntaxis, waarin een MINC-bestand met verschillende benoemde dimensies wordt beschreven
(xspace, yspace en zspace), variabelen (zspace, image), variabeleattributen (valid_range,
signtype), en enkele gegevens. CDL-trefwoorden zijn vetgedrukt. (Dit voorbeeld is bedoeld om
illustreer de syntaxis; een echt CDL-bestand zou dus een completere set attributen hebben
dat de gegevens vollediger zelfbeschrijvend zouden zijn.)

netcdf foo {// een voorbeeld van een MINC-specificatie in CDL

Afmeting:
xspatie = 8;
yspatie = 8;
zspatie = 5;

variabelen:
drijven xruimte;
drijven yspatie;
drijven zruimte(zruimte);
kort afbeelding(zruimte,yruimte,xruimte);
verdubbelen afbeelding-min(zspatie)
verdubbelen afbeelding-max(zspatie)

// variabele attributen
afbeelding:geldig_bereik = 0,5;
gegevens:
image-min = -1,-1,-1,-1,-1;
afbeelding-max = 1,1,1,1,1;
afbeelding =
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;
zspatie = 0,2,3.5,7,10;
}

Alle CDL-instructies worden afgesloten met een puntkomma. Spaties, tabs en nieuwe regels kunnen worden gebruikt
vrij voor de leesbaarheid. Opmerkingen kunnen op elke regel de tekens `//' volgen.

Een CDL-beschrijving bestaat uit drie optionele delen: Afmeting, variabelen en gegevens,
beginnend met het trefwoord dimensies:, variabelen: en gegevens, respectievelijk. De variabele
onderdeel kan bevatten variabele verklaringen en attribuut opdrachten.

Een MINC dimensie wordt gebruikt om de vorm van een of meer van de multidimensionale te definiëren
variabelen in het MINC-bestand. Een MINC-dimensie heeft een naam, een maat en mogelijk
diverse andere attributen.

A variabele staat voor een multidimensionale reeks waarden van hetzelfde type. Een variabele heeft
een naam, een gegevenstype en een vorm die wordt beschreven door de lijst met dimensies. Elke variabele kan
hebben ook geassocieerd met attributen (zie hieronder) evenals gegevenswaarden. De naam, het gegevenstype,
en vorm van een variabele worden gespecificeerd door zijn declaratie in de variabele sectie van een CDL
Omschrijving. Een variabele kan dezelfde naam hebben als een dimensie; volgens afspraak zoals
variabele is eendimensionaal en bevat coördinaten van de dimensie die het noemt.
Dimensies hoeven geen overeenkomstige variabelen te hebben.

Een netCDF attribuut bevat informatie over een netCDF-variabele of over de hele netCDF
gegevensset. Attributen worden gebruikt om eigenschappen te specificeren zoals eenheden, speciale waarden, maximum
en minimum geldige waarden, schaalfactoren, offsets en parameters. Attribuut informatie
wordt weergegeven door enkele waarden of arrays van waarden. Bijvoorbeeld, "eenheden" is een attribuut
weergegeven door een tekenreeks zoals "celsius". Een attribuut heeft een geassocieerd
variabele, een naam, een gegevenstype, een lengte en een waarde. In tegenstelling tot variabelen die
bedoeld voor data, attributen zijn bedoeld voor metadata (data over data).

In CDL wordt een attribuut aangeduid door een variabele en attribuutnaam, gescheiden door `:'. Het
is mogelijk toe te wijzen globaal attributen die niet aan een variabele aan het bestand zijn gekoppeld als een
geheel door `:' vóór de attribuutnaam te gebruiken. Het gegevenstype van een attribuut in CDL is
afgeleid van het type waarde dat eraan is toegewezen. De lengte van een attribuut is de
aantal gegevenswaarden dat eraan is toegewezen, of het aantal tekens in de tekenreeks
eraan toegewezen. Meerdere waarden worden toegewezen aan niet-tekenattributen door ze te scheiden
de waarden met komma's. Alle waarden die aan een kenmerk zijn toegewezen, moeten van hetzelfde type zijn.

De namen voor CDL-dimensies, variabelen en attributen moeten beginnen met een letter
teken of `_', en volgende tekens kunnen alfanumeriek of `_' of `-' zijn.

De optionele gegevens sectie van een CDL-specificatie is waar variabelen kunnen worden geïnitialiseerd.
De syntaxis van een initialisatie is eenvoudig: een variabelenaam, een gelijkteken en een komma.
gescheiden lijst met constanten (mogelijk gescheiden door spaties, tabs en nieuwe regels) beëindigd
met een puntkomma. Voor multidimensionale arrays varieert de laatste dimensie het snelst. Dus
Voor matrices wordt rijvolgorde in plaats van kolomvolgorde gebruikt. Als er minder waarden worden opgegeven
dan nodig zijn om een ​​variabele te vullen, wordt deze uitgebreid met een type-afhankelijke `vulwaarde',
die kan worden overschreven door een waarde op te geven voor een onderscheidend variabel attribuut met de naam
`_FillValue'. De typen constanten hoeven niet overeen te komen met het type dat voor een variabele is gedeclareerd;
Er worden bijvoorbeeld dwangmaatregelen toegepast om gehele getallen om te zetten in drijvende komma. De constante `_'
kan worden gebruikt om de vulwaarde voor een variabele aan te geven.

Primitief Data Types
verkolen tekens
byte 8-bit data
kort 16-bits gehele getallen met teken
lang 32-bits gehele getallen met teken
int (synoniem met lang)
drijven IEEE enkele precisie drijvende komma (32 bits)
vast (synoniem met drijven)
verdubbelen IEEE dubbele precisie drijvende komma (64 bits)

Behalve het toegevoegde gegevenstype byte en het gebrek aan Ongesigneerd, ondersteunt CDL hetzelfde
primitieve gegevenstypen als C. De namen voor de primitieve gegevenstypen zijn gereserveerde woorden in
CDL, dus de namen van variabelen, dimensies en attributen mogen geen typenamen zijn. In
declaraties kunnen typenamen worden opgegeven in hoofdletters of kleine letters.

Bytes verschillen van karakters doordat ze bedoeld zijn om acht bits aan gegevens te bevatten,
en de nulbyte heeft geen speciale betekenis, zoals voor karaktergegevens.

Shorts kunnen waarden tussen -32768 en 32767 bevatten.

Longs kunnen waarden bevatten tussen -2147483648 en 2147483647. int en geheel getal worden geaccepteerd als
synoniemen voor lang in CDL-aangiften. Nu er platforms zijn met 64-bit
representaties voor C longs, kan het beter zijn om de int synoniem om verwarring te voorkomen.

Floats kunnen waarden bevatten tussen ongeveer -3.4+38 en 3.4+38. Hun externe vertegenwoordiging is
als 32-bits IEEE genormaliseerde single-precision floating point getallen. vast wordt geaccepteerd als een
synoniem voor drijven in CDL-aangiften.

Doubles kunnen waarden bevatten tussen ongeveer -1.7+308 en 1.7+308. Hun externe vertegenwoordiging
is als 64-bits IEEE-standaard genormaliseerde dubbele precisie drijvende-kommagetallen.

CDL constanten
Constanten die aan attributen of variabelen zijn toegewezen, kunnen van elk van de basis-MINC-typen zijn. De
De syntaxis voor constanten is vergelijkbaar met de syntaxis van C, behalve dat er type-achtervoegsels aan moeten worden toegevoegd
shorts en floats om ze te onderscheiden van longs en doubles.

A byte constante wordt weergegeven door een escape-reeks van één teken of meerdere tekens
tussen enkele aanhalingstekens geplaatst. Bijvoorbeeld,
'a' // ASCII 'a'
'\0' // een nulbyte
'\n' // ASCII-teken voor nieuwe regel
'\33' // ASCII-escape-teken (33 octaal)
'\x2b' // ASCII plus (2b hex)
'\377' // 377 octaal = 255 decimaal, niet-ASCII

Tekenconstanten staan ​​tussen dubbele aanhalingstekens. Er kan een tekenarray worden weergegeven
als een string tussen dubbele aanhalingstekens. De gebruikelijke ontsnappingsconventies in de C-reeks worden gerespecteerd.
Bij voorbeeld
"a" // ASCII `a'
"Twee\nlijnen\n" // een tekenreeks van 10 tekens met twee ingesloten nieuwe regels
"a bell:\007" // een string met een ASCII-bel
Merk op dat de karakterarray "a" in een variabele van één element zou passen, aangezien nee
afsluitend NULL-teken wordt aangenomen. Een nulbyte in een tekenreeks is echter
geïnterpreteerd als het einde van de significante karakters door de minidump programma, volgt
de C-conventie. Daarom mag een NULL-byte niet in een tekenreeks worden ingebed
tenzij op het einde: gebruik de byte gegevenstype in plaats daarvan voor byte-arrays die de nul bevatten
byte. MINC en CDL hebben geen stringtype, maar alleen karakterarrays met een vaste lengte
multidimensionaal zijn.

kort integer-constanten zijn bedoeld voor het weergeven van 16-bits getekende hoeveelheden. Het formulier
een kort constante is een geheel getal constant met een `s' of `S' toegevoegd. Als een kort
constante begint met '0', wordt het geïnterpreteerd als octaal, behalve dat als het begint met '0x',
het wordt geïnterpreteerd als een hexadecimale constante. Bijvoorbeeld:
-2s // een korte -2
0123s // octaal
0x7ffs //hexadecimaal

lang integer-constanten zijn bedoeld voor het weergeven van 32-bits getekende hoeveelheden. Het formulier
een lang constante is een gewone constante met een geheel getal, hoewel het acceptabel is om een ​​toe te voegen
optionele `l' of `L'. Als een lang constante begint met `0', wordt geïnterpreteerd als octaal,
behalve dat als het begint met `0x', het wordt geïnterpreteerd als een hexadecimale constante. Voorbeelden
van geldig lang constanten zijn onder meer:
-2
1234567890L
0123 // octaal
0x7ff // hexadecimaal

Drijvende-kommaconstanten van het type drijven geschikt zijn om drijvende komma weer te geven
gegevens met een nauwkeurigheid van ongeveer zeven significante cijfers. de vorm van a drijven constante is
hetzelfde als een constante C met een drijvende komma waaraan een 'f' of 'F' is toegevoegd. bijvoorbeeld de
volgende zijn allemaal acceptabel: drijven constanten:
-2.0f
3.14159265358979f // wordt afgekapt met minder precisie
1. f

Drijvende-kommaconstanten van het type verdubbelen geschikt zijn om drijvende komma weer te geven
gegevens met een nauwkeurigheid van ongeveer zestien significante cijfers. de vorm van a verdubbelen constante is
hetzelfde als een drijvende-kommaconstante C. Een optionele `d' of `D' kan worden toegevoegd. Voor
voorbeeld de volgende zijn allemaal acceptabel: verdubbelen constanten:
-2.0
3.141592653589793
1.0e-20
1. d

Gebruik mincgen online met behulp van onworks.net-services