mincgen - Online în cloud

PROGRAM:

NUME

mincgen - Generați un fișier MINC dintr-un fișier CDL.

REZUMAT

mincgen [-b] [-n] [-o minc_filename] fișier de intrare

DESCRIERE

mincgen generează un fișier MINC. Intrarea către mincgen este o descriere a unui fișier MINC într-un
limbaj mic cunoscut sub numele de CDL (Network Common Data form Language), descris mai jos. Daca nu
opțiunile sunt specificate în invocare mincgen, doar verifică sintaxa CDL-ului de intrare
fișier, producând mesaje de eroare pentru orice încălcare a sintaxei CDL. Alte opțiuni pot fi
folosit pentru a crea fișierul MINC corespunzător.

mincgen poate fi utilizat cu programul însoțitor mincdump pentru a efectua niște operații simple
pe fișierele MINC. De exemplu, pentru a redenumi o dimensiune într-un fișier MINC, utilizați mincdump pentru a obține o
Versiunea CDL a fișierului MINC, editați fișierul CDL pentru a schimba numele dimensiunilor și
utilizare mincgen pentru a genera fișierul MINC corespunzător din fișierul CDL editat.

OPŢIUNI

-b Creați un fișier MINC (binar). Dacă -o opțiunea este absentă, un nume de fișier implicit va fi
să fie construit din numele MINC (specificat după netcdf or hdf5 cuvânt cheie în
intrarea) prin adăugarea extensiei `.mnc'. Dacă un fișier există deja cu
numele specificat, acesta va fi suprascris.

-o minc_filename
Numele fișierului binar MINC creat. Dacă această opțiune este specificată, înseamnă că
"-b". (Această opțiune este necesară deoarece fișierele MINC nu pot fi scrise
direct la ieșirea standard, deoarece ieșirea standard nu poate fi căutată.)

EXEMPLE

Verificați sintaxa fișierului CDL `foo.cdl':

mincgen foo.cdl

Din fișierul CDL `foo.cdl', generați un fișier MINC binar echivalent numit `x.mnc':

mincgen -o x.mnc foo.cdl

UTILIZARE

CDL Sintaxă Rezumat
Mai jos este un exemplu de sintaxă CDL, care descrie un fișier MINC cu mai multe dimensiuni denumite
(xspace, yspace și zspace), variabile (zspace, imagine), atribute variabile (valabil_range,
tip de semn) și unele date. Cuvintele cheie CDL sunt cu caractere aldine. (Acest exemplu este destinat să
ilustrează sintaxa; un fișier CDL real ar avea un set mai complet de atribute deci
că datele ar fi mai complet autodescriere.)

netcdf foo { // un exemplu de specificație MINC în CDL

Dimensiuni:
xspace = 8;
yspace = 8;
zspace = 5;

variabile:
pluti xspace;
pluti yspace;
pluti zspace(zspace);
mic de statura imagine(zspace,yspace,xspace);
dubla imagine-min(zspace)
dubla imagine-max(zspace)

// atribute variabile
imagine: interval_valid = 0,5;
de date:
image-min = -1,-1,-1,-1,-1;
imagine-max = 1,1,1,1,1;
imagine =
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;
}

Toate instrucțiunile CDL sunt încheiate cu punct și virgulă. Pot fi folosite spații, file și linii noi
liber pentru lizibilitate. Comentariile pot urma caracterele „//” pe orice rând.

O descriere CDL constă din trei părți opționale: Dimensiuni, variabile, și de date,
începând cu cuvântul cheie dimensiuni:, variabile:, și de date, respectiv. Variabila
parte poate conține variabil declarații și atribut misiuni.

A MINC dimensiune este folosit pentru a defini forma unuia sau mai multor multidimensionale
variabilele conținute în fișierul MINC. O dimensiune MINC are un nume, o dimensiune și, eventual
alte câteva atribute.

A variabil reprezintă o matrice multidimensională de valori de același tip. O variabilă are
un nume, un tip de date și o formă descrise de lista sa de dimensiuni. Fiecare variabilă poate
au de asemenea asociate atribute (vezi mai jos), precum și valorile datelor. Numele, tipul de date,
și forma unei variabile sunt specificate prin declarația acesteia în variabil secțiunea unui CDL
Descriere. O variabilă poate avea același nume ca o dimensiune; prin conventie astfel de
variabila este unidimensională și conține coordonatele dimensiunii pe care o numește.
Dimensiunile nu trebuie să aibă variabile corespunzătoare.

Un netCDF atribut conține informații despre o variabilă netCDF sau despre întregul netCDF
set de date. Atributele sunt folosite pentru a specifica proprietăți precum unități, valori speciale, maxim
și valori minime valide, factori de scalare, decalaje și parametri. Informații despre atribute
este reprezentat prin valori individuale sau matrice de valori. De exemplu, „unități” este un atribut
reprezentată printr-o matrice de caractere precum „celsius”. Un atribut are asociat
variabilă, un nume, un tip de date, o lungime și o valoare. Spre deosebire de variabilele care sunt
destinate datelor, atributele sunt destinate metadatelor (date despre date).

În CDL, un atribut este desemnat printr-o variabilă și un nume de atribut, separate prin „:”. Aceasta
este posibil să se atribuie global atribute care nu sunt asociate cu nicio variabilă a fișierului ca a
întreg folosind `:' înaintea numelui atributului. Tipul de date al unui atribut în CDL este
derivat din tipul valorii care i se atribuie. Lungimea unui atribut este
numărul de valori de date atribuite acestuia sau numărul de caractere din șirul de caractere
atribuite acestuia. Mai multe valori sunt atribuite atributelor non-caracter prin separare
valorile cu virgule. Toate valorile atribuite unui atribut trebuie să fie de același tip.

Numele pentru dimensiunile, variabilele și atributele CDL trebuie să înceapă cu un alfabet
caracterul sau „_”, iar caracterele ulterioare pot fi alfanumerice sau „_” sau „-”.

Opțional de date secțiunea unei specificații CDL este locul unde variabilele pot fi inițializate.
Sintaxa unei inițializare este simplă: un nume de variabilă, un semn egal și o virgulă.
listă delimitată de constante (eventual separate prin spații, tab-uri și linii noi) terminată
cu punct și virgulă. Pentru tablourile multidimensionale, ultima dimensiune variază cel mai repede. Prin urmare
Pentru matrice este folosită ordinea rândurilor, mai degrabă decât ordinea coloanelor. Dacă sunt furnizate mai puține valori
decât sunt necesare pentru a completa o variabilă, aceasta este extinsă cu o „valoare de umplere” dependentă de tip,
care poate fi suprascris prin furnizarea unei valori pentru un atribut variabil distinct numit
`_FillValue'. Tipurile de constante nu trebuie să se potrivească cu tipul declarat pentru o variabilă;
se fac constrângeri pentru a converti numerele întregi în virgulă mobilă, de exemplu. constanta `_'
poate fi folosit pentru a desemna valoarea de umplere pentru o variabilă.

Primitiv Date Tipuri de
car de război caractere
octet Datele 8-biți
mic de statura numere întregi semnate pe 16 biți
lung numere întregi semnate pe 32 biți
int (sinonim cu lung)
pluti IEEE virgulă mobilă de precizie unică (32 de biți)
real (sinonim cu pluti)
dubla IEEE dublă precizie în virgulă mobilă (64 de biți)

Cu excepția tipului de date adăugat octet iar lipsa de nesemnat, CDL acceptă același lucru
tipuri de date primitive ca C. Numele pentru tipurile de date primitive sunt cuvinte rezervate în
CDL, deci numele variabilelor, dimensiunilor și atributelor nu trebuie să fie nume de tip. În
declarații, numele tipurilor pot fi specificate fie cu litere mari, fie cu litere mici.

Octeții diferă de caractere prin faptul că sunt menționați să dețină opt biți de date,
iar octetul zero nu are o semnificație specială, așa cum o are pentru datele de caractere.

Pantalonii scurti pot păstra valori între -32768 și 32767.

Longurile pot deține valori între -2147483648 și 2147483647. int și întreg sunt acceptate ca
sinonime pentru lung în declaraţiile CDL. Acum că există platforme cu 64 de biți
reprezentări pentru C longs, poate fi mai bine să folosiți int sinonim pentru a evita confuzia.

Flotatoarele pot păstra valori între aproximativ -3.4+38 și 3.4+38. Reprezentarea lor externă este
ca numere cu virgulă mobilă cu precizie unică normalizate IEEE pe 32 de biți. real este acceptat ca a
sinonim pentru pluti în declaraţiile CDL.

Dublele pot deține valori între aproximativ -1.7+308 și 1.7+308. Reprezentarea lor externă
este ca numere cu virgulă mobilă cu precizie dublă normalizate standard IEEE pe 64 de biți.

CDL constante
Constantele atribuite atributelor sau variabilelor pot fi de oricare dintre tipurile MINC de bază. The
sintaxa pentru constante este similară cu sintaxa C, cu excepția faptului că trebuie adăugate sufixe de tip
pantaloni scurți și flotoare pentru a le distinge de lungi și duble.

A octet constanta este reprezentată de un singur caracter sau secvență de evadare cu mai multe caractere
cuprinse între ghilimele simple. De exemplu,
'a' // ASCII `a'
„\0” // un octet zero
'\n' // caracter ASCII newline
„\33” // caracter de escape ASCII (33 octal)
„\x2b” // ASCII plus (2b hex)
„\377” // 377 octal = 255 zecimale, non-ASCII

Constantele caracterelor sunt cuprinse între ghilimele duble. Poate fi reprezentată o matrice de caractere
ca un șir cuprins între ghilimele duble. Sunt respectate convențiile obișnuite de evadare a șirurilor C.
De exemplu
"a" // ASCII `a'
„Două\nlinii\n” // un șir de 10 caractere cu două linii noi încorporate
„a bell:\007” // un șir care conține un sonerie ASCII
Rețineți că matricea de caractere „a” s-ar încadra într-o variabilă cu un singur element, deoarece nu
se presupune caracterul NULL final. Cu toate acestea, un octet zero într-o matrice de caractere este
interpretat ca sfârșitul personajelor semnificative de către mincdump program, urmând
convenția C. Prin urmare, un octet NULL nu ar trebui să fie încorporat într-un șir de caractere
cu excepția cazului în care la sfârșit: utilizați octet tip de date în schimb pentru matricele de octeți care conțin zero
octet. MINC și CDL nu au tip de șir, ci doar matrice de caractere cu lungime fixă, ceea ce poate
fi multidimensional.

mic de statura Constantele întregi sunt destinate reprezentării cantităților cu semn de 16 biți. Forma
a unui mic de statura constanta este o constantă întreagă cu un „s” sau „S” adăugat. În cazul în care o mic de statura
constanta începe cu „0”, este interpretată ca octală, cu excepția faptului că, dacă începe cu „0x”,
este interpretată ca o constantă hexazecimală. De exemplu:
-2s // un scurt -2
0123s // octal
0x7ffs //hexazecimal

Lung Constantele întregi sunt destinate reprezentării cantităților cu semn de 32 biți. Forma
a unui lung constanta este o constantă întreagă obișnuită, deși este acceptabil să adăugați an
opțional „l” sau „L”. În cazul în care o lung constanta începe cu „0”, este interpretată ca octală,
cu excepția faptului că, dacă începe cu `0x', este interpretat ca o constantă hexazecimală. Exemple
de valabil lung constantele includ:
-2
1234567890L
0123 // octal
0x7ff // hexazecimal

Constante de tip virgulă mobilă pluti sunt adecvate pentru reprezentarea virgulă mobilă
date cu aproximativ șapte cifre semnificative de precizie. Forma de a pluti constantă este
la fel ca o constantă în virgulă mobilă C cu un „f” sau „F” adăugat. De exemplu cel
următoarele sunt toate acceptabile pluti constante:
-2.0f
3.14159265358979f // va fi trunchiat la o precizie mai mică
1f

Constante de tip virgulă mobilă dubla sunt adecvate pentru reprezentarea virgulă mobilă
date cu aproximativ șaisprezece cifre semnificative de precizie. Forma de a dubla constantă este
la fel ca o constantă în virgulă mobilă C. Se poate adăuga un „d” sau „D” opțional. Pentru
exemplu, următoarele sunt toate acceptabile dubla constante:
-2.0
3.141592653589793
1.0-20
1.d

Utilizați mincgen online folosind serviciile onworks.net