mincdump - Online în cloud

PROGRAM:

NUME

mincdump - Convertiți fișierele minc în formă ASCII (CDL)

REZUMAT

mincdump [-c] [-h] [-v var1,...] [-b lang] [-f lang] [-l len] [-n nume] [-p
f_digits[,d_digits]] fişier

DESCRIERE

mincdump se bazează pe instrumentul netCDF ncdump, modificat pentru a funcționa atât cu MINC 1 (netCDF)
și fișiere în format MINC 2 (HDF5). Este destinat utilizării în principal cu scripturi precum
mincdiff și mincheader. Din moment ce nu a fost creat la Institutul Neurologic din Montreal
nu respectă convențiile obișnuite pentru programele MINC.

mincdump generează o reprezentare ASCII a unui fișier minc specificat pe o ieșire standard.
Reprezentarea ASCII este într-o formă numită CDL (``Network Common Data form Language'')
care pot fi vizualizate, editate sau servi ca intrare la ncgen. ncgen este un program însoțitor care
poate genera un fișier minc binar dintr-un fișier CDL. Prin urmare ncgen și mincdump pot fi utilizate ca
inverse pentru a transforma reprezentarea datelor între reprezentări binare și ASCII.
Vedea ncgen pentru o descriere a reprezentărilor CDL și netCDF.

mincdump definește un format implicit utilizat pentru fiecare tip de date netCDF, dar acesta poate fi
modificat dacă un atribut „C_format” este definit pentru o variabilă netCDF. În acest caz,
mincdump va folosi atributul `C_format' pentru a formata fiecare valoare. De exemplu, dacă
Se știe că datele în virgulă mobilă pentru variabila netCDF „Z” sunt exacte doar la trei
cifre semnificative, ar fi adecvat să se utilizeze atributul variabilă

Z:C_format = "%.3g"

mincdump poate fi folosit și ca un simplu browser pentru fișierele de date netCDF, pentru a afișa
nume de dimensiuni și dimensiuni; nume de variabile, tipuri și forme; nume și valori ale atributelor;
și opțional, valorile datelor pentru toate variabilele sau variabilele selectate dintr-un netCDF
fișier.

mincdump folosește `_' pentru a reprezenta valorile datelor care sunt egale cu atributul `_FillValue'
pentru o variabilă, menită să reprezinte date care nu au fost încă scrise. Dacă o variabilă
nu are atribut `_FillValue', valoarea de umplere implicită pentru tipul de variabilă este utilizată dacă
variabila nu este de tip octet.

OPŢIUNI

-c Arată valorile lui coordona variabile (variabile care sunt și dimensiuni) ca
precum și declarațiile tuturor dimensiunilor, variabilelor și valorilor atributelor. Date
valorile variabilelor necoordonate nu sunt incluse în rezultat. Acesta este
cea mai potrivită opțiune de utilizat pentru o scurtă privire asupra structurii și conținutului unui
fișier netCDF.

-h Arată numai antet informațiile din ieșire, adică declarațiile de
dimensiuni, variabile și atribute, dar nu există valori de date pentru orice variabilă. The
ieșirea este identică cu utilizarea -c opțiune, cu excepția faptului că valorile de coordonate
variabilele nu sunt incluse. (Cel mult unul dintre -c or -h pot fi prezente opțiuni.)

-v var1,...,varn
Ieșirea va include valorile datelor pentru variabilele specificate, în plus față de
declarații ale tuturor dimensiunilor, variabilelor și atributelor. Una sau mai multe variabile
trebuie specificate după nume în lista delimitată prin virgulă care urmează acestei opțiuni. The
listă trebuie să fie un singur argument pentru comandă, prin urmare nu poate conține spații libere sau altele
caractere cu spațiu alb. Variabilele numite trebuie să fie variabile netCDF valide în
fișier de intrare. Implicit, fără această opțiune și în absența -c or -h
opțiuni, este de a include valorile datelor pentru toate variabile în ieșire.

-b lang
O scurtă adnotare sub forma unui comentariu CDL (text care începe cu caracterele
``//'') va fi inclus în secțiunea de date a rezultatului pentru fiecare `rând' de date,
pentru a ajuta la identificarea valorilor datelor pentru variabilele multidimensionale. Dacă lang începe cu
„C” sau „c”, apoi vor fi folosite convențiile limbajului C (indici bazați pe zero, ultimul
dimensiunea variind cel mai repede). Dacă lang începe cu „F” sau „f”, apoi limba Fortran
vor fi utilizate convențiile (indici unilaterali, prima dimensiune variind cel mai rapid). În
în orice caz, datele vor fi prezentate în aceeași ordine; doar adnotările
va diferi. Această opțiune este utilă pentru a naviga prin volume mari de
date multidimensionale.

-f lang
Adnotări complete sub formă de comentarii CDL finale (text care începe cu
caracterele ``//'') pentru fiecare valoare de date (cu excepția caracterelor individuale din caracter
matrice) vor fi incluse în secțiunea de date. Dacă lang începe cu „C” sau „c”, apoi
Se vor folosi convențiile limbajului C (indici bazați pe zero, ultima dimensiune variind
cel mai rapid). Dacă lang începe cu „F” sau „f”, apoi convențiile limbajului Fortran vor
să fie utilizați (indici unici, prima dimensiune variind cel mai rapid). În ambele cazuri,
datele vor fi prezentate în aceeași ordine; doar adnotările vor diferi. Acest
opțiunea poate fi utilă pentru canalizarea datelor în alte filtre, deoarece fiecare valoare de date
apare pe o linie separată, complet identificat.

-l len Modifică lungimea maximă implicită a liniei (80) utilizată în listele de formatare de non-
valorile datelor caracterelor.

-n nume
CDL necesită un nume pentru un set de date netCDF, pentru utilizare de către ncgen -b în generarea unui
nume de fișier netCDF implicit. În mod implicit, mincdump construieşte acest nume din ultimul
componentă a căii fișierului netCDF de intrare prin eliminarea oricărei extensii
are. Folosește -n opțiunea de a specifica un alt nume. Deși fișierul de ieșire
nume folosit de ncgen -b poate fi specificat, poate fi înțelept să aveți mincdump schimba
nume implicit pentru a evita suprascrierea accidentală a unui fișier netCDF valoros atunci când îl utilizați
mincdump, editând fișierul CDL rezultat și utilizând ncgen -b pentru a genera un nou
netCDF din fișierul CDL editat.

-p cifre_float[,cifre_duble]
Specifică precizia implicită (numărul de cifre semnificative) de utilizat la afișare
valori de date în virgulă mobilă sau dublă precizie pentru atribute și variabile. Dacă
specificat, această valoare înlocuiește valoarea atributului „C_format” pentru oricare
variabilă care are un astfel de atribut. Datele în virgulă mobilă vor fi afișate cu
float_digits cifre semnificative. Dacă cifre_duble este de asemenea specificat, dublu-
valorile de precizie vor fi afișate cu atât de multe cifre semnificative. În
absența vreunuia -p specificațiile, datele în virgulă mobilă și cu precizie dublă sunt
afișat cu 7 și, respectiv, 15 cifre semnificative. Se pot face fișiere CDL
mai mic dacă este necesară o precizie mai mică. Dacă atât în ​​virgulă mobilă, cât și în dublă presiune
sunt specificate precizii, cele două valori trebuie să apară separate prin virgulă (nr
spații libere) ca un singur argument pentru comandă. Dacă chiar vrei până la urmă
precizie din fișierul netCDF reprezentat în fișierul CDL pentru toate posibilele
valori în virgulă mobilă, va trebui să specificați acest lucru cu -p 9,17 (conform
Teorema 15 a lucrării enumerate la REFERINȚE).

EXEMPLE

Uitați-vă la structura datelor din fișierul netCDF `foo.mnc':

mincdump -c foo.mnc

Produceți o versiune CDL adnotată a structurii și a datelor în fișierul netCDF `foo.mnc',
folosind indexarea în stil C pentru adnotări:

mincdump -bc foo.mnc > foo.cdl

Date de ieșire numai pentru variabilele „uwind” și „vwind” din fișierul netCDF „foo.mnc', și
arată datele în virgulă mobilă cu doar trei cifre semnificative de precizie:

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

Produceți o listă complet adnotată (o valoare de date pe linie) a datelor pentru variabilă
„omega”, folosind convențiile Fortran pentru indici și schimbând numele setului de date netCDF în
fișierul CDL rezultat la „omega”:

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

Utilizați mincdump online folosind serviciile onworks.net