ncdump - Online în cloud

PROGRAM:

NUME

ncdump - Convertiți fișierul netCDF în formă text (CDL)

REZUMAT

ncdump [-chistxw] [-v var1,...] [-b lang] [-f lang] [-l len] [-n nume] [-p
f_digits[,d_digits]] [-g grp1,...] fişier

ncdump -k fişier

DESCRIERE

ncdump utilitarul generează o reprezentare text a unui fișier netCDF specificat în standard
ieșire, excluzând opțional unele sau toate datele variabile din ieșire. Textul
reprezentarea este într-o formă numită CDL (network Common Data form Language) care poate fi
vizualizate, editate sau servite ca intrare la ncgen, un program însoțitor care poate genera un binar
netCDF dintr-un fișier CDL. Prin urmare ncgen și ncdump poate fi folosit ca invers pentru transformare
reprezentarea datelor între reprezentări binare și text. Vedea ncgen documentaţie
pentru o descriere a reprezentărilor CDL și netCDF.

ncdump poate fi folosit și pentru a determina ce fel de fișier netCDF este utilizat (ce variantă de
formatul de fișier netCDF) cu opțiunea -k.

Dacă suportul DAP a fost activat când ncdump a fost construit, numele fișierului poate specifica o adresă URL DAP.
Asta permite ncdump pentru a accesa surse de date de pe serverele DAP, inclusiv date din alte servere
formate decât netCDF. Când este utilizat cu adrese URL DAP, ncdump arată traducerea din DAP
model de date la modelul de date netCDF.

ncdump poate fi folosit și ca un simplu browser pentru fișierele de date netCDF, pentru a afișa
nume de dimensiuni și lungimi; nume de variabile, tipuri și forme; nume de atribute și
valori; și opțional, valorile datelor pentru toate variabilele sau variabilele selectate din a
fișier netCDF. Pentru fișierele netCDF-4, sunt incluse și grupurile și tipurile definite de utilizator
ieșire ncdump.

ncdump 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ă are
fără atribut `_FillValue', valoarea de umplere implicită pentru tipul de variabilă este utilizată, cu excepția cazului în care
variabila este de tip octet.

ncdump definește un format de afișare 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, ncdump
va folosi atributul `C_format' pentru a formata fiecare valoare. De exemplu, dacă este în virgulă mobilă
se știe că datele pentru variabila netCDF „Z” sunt exacte cu doar trei cifre semnificative,
ar fi potrivit să se folosească atributul variabil

Z:C_format = "%.3g"

OPŢIUNI

-c Arată valorile lui coordona variabile (variabile 1D cu aceleași nume ca
dimensiuni), precum și declarațiile tuturor dimensiunilor, variabilelor, atributelor
valori, grupuri și tipuri definite de utilizator. Valorile datelor ale variabilelor necoordonate
nu sunt incluse în ieșire. Aceasta este de obicei 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ă de ieșire numai
declarații pentru dimensiuni, variabile, atribute, grupuri și definite de utilizator
tipuri de fișier de intrare, dar nu există valori de date pentru orice variabilă. Ieșirea este
identic cu utilizarea -c opțiune cu excepția faptului că valorile variabilelor de coordonate sunt
nu este inclus. (Cel mult unul dintre -c or -h pot fi prezente opțiuni.)

-v var1,...
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 fără escape
spații libere sau alte caractere de spațiu alb. Variabilele numite trebuie să fie netCDF valide
variabilele din fișierul de intrare. O variabilă dintr-un grup dintr-un fișier netCDF-4 poate fi
specificat cu un nume de cale absolut, cum ar fi `/GroupA/GroupA2/var'. Utilizarea unui
numele de cale relativă, cum ar fi „var” sau „grp/var” specifică toate numele variabilelor care se potrivesc
în dosar. 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 [c|f]
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 poate fi utilă pentru a naviga prin volume mari de
date multidimensionale.

-f [c|f]
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. Dacă lang începe cu „F” sau „f”, apoi Fortran
vor fi folosite convențiile lingvistice. În ambele cazuri, datele vor fi prezentate în
aceeași ordine; doar adnotările vor diferi. Această opțiune poate fi utilă pentru
introducerea datelor în alte filtre, deoarece fiecare valoare de date apare pe o linie separată,
pe deplin identificate. (Cel mult una dintre opțiunile „-b” sau „-f” poate fi prezentă.)

-l lungime
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 fișier netCDF, pentru a fi utilizat de către ncgen -b în generarea unui implicit
nume de fișier netCDF. În mod implicit, ncdump construiește acest nume din ultima componentă
a numelui fișierului netCDF de intrare prin eliminarea oricărei extensii pe care o are.
Folosește -n opțiunea de a specifica un alt nume. Deși numele fișierului de ieșire utilizat
by ncgen -b poate fi specificat, poate fi înțelept să aveți ncdump schimba numele implicit
pentru a evita suprascrierea din greșeală a unui fișier netCDF valoros în timpul utilizării ncdump,
editarea fișierului CDL rezultat și utilizarea ncgen -b pentru a genera un nou fișier 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, dacă există, pentru a
variabil. Datele în virgulă mobilă vor fi afișate cu float_digits semnificativ
cifre. Dacă cifre_duble este de asemenea specificat, valorile cu precizie dublă vor fi
afișat cu atât de multe cifre semnificative. În lipsa vreunuia -p
specificațiile, datele în virgulă mobilă și cu precizie dublă sunt afișate cu 7 și
15 cifre semnificative, respectiv. Fișierele CDL pot fi făcute mai mici dacă sunt mai mici
se cere precizie. Dacă sunt specificate atât precizia în virgulă mobilă, cât și precizia dublă,
cele două valori trebuie să apară separate prin virgulă (fără spații libere) ca un singur argument pentru
comanda. (Pentru a reprezenta fiecare ultim bit de precizie într-un fișier CDL pentru toți
ar necesita valori posibile în virgulă mobilă -p 9,17.)

-k Afișați tipul de fișier netCDF referințele la numele căii, una dintre „clasic”, „64 de biți”.
offset”, „netCDF-4” sau „model clasic netCDF-4”. Înainte de versiunea 3.6, a existat
un singur tip de fișier netCDF, desemnat ca „clasic” (cunoscut și ca variantă de format
1). Suportul pentru fișiere mari a introdus o altă variantă a formatului, desemnată ca
`64-bit offset' (cunoscut ca varianta de format 2). NetCDF-4, folosește o a treia variantă a
format, `netCDF-4' (varianta de format 3). O altă variantă de format, desemnată
`netCDF-4 model clasic' (varianta de format 4), este limitat la caracteristicile suportate de
modelul de date netCDF-3 dar reprezentat folosind formatul HDF5, astfel încât an
programul netCDF-3 nemodificat poate citi sau scrie fișierul doar prin reconectarea cu
biblioteca netCDF-4. Ieșirea șirului prin utilizarea opțiunii „-k” poate fi furnizată ca
valoarea opțiunii `-k' la ncgen(1) pentru a specifica exact ce fel de netCDF
fișier de generat, atunci când doriți să înlocuiți valoarea implicită dedusă din CDL.

-s Produceți atribute virtuale speciale care oferă informații legate de performanță
despre formatul fișierului și proprietățile variabilelor pentru datele netCDF-4. Acestea speciale
atributele virtuale nu fac de fapt parte din date, ele sunt doar un convenabil
mod de a afișa proprietăți diverse ale datelor în CDL (și eventual NcML).
Acestea includ `_ChunkSizes', `_DeflateLevel', `_Endianness', `_Fletcher32',
`_Format', `_NoFill', `_Shuffle' și `_Storage'. `_ChunkSizes' este o listă de bucăți
dimensiuni pentru fiecare dimensiune a variabilei. `_DeflateLevel' este un număr întreg între 0
și 9 inclusiv dacă a fost specificată compresia pentru variabilă. `_Endianness'
este fie „mic”, fie „mare”, în funcție de modul în care variabila a fost stocată prima dată
scris. `_Fletcher32' este `adevărat' dacă proprietatea sumei de control a fost setată pentru
variabil. `_Format' este un atribut global care specifică varianta formatului netCDF,
unul dintre „clasic”, „decalaj pe 64 de biți”, „netCDF-4” sau „model clasic netCDF-4”.
`_NoFill' este `true' dacă proprietatea persistentă NoFill a fost setată pentru variabila când
a fost definit. `_Shuffle' este `true' dacă a fost specificată utilizarea filtrului shuffle
pentru variabila. „_Storage” este „contiguu” sau „în bucăți”, în funcție de modul în care
datele variabilei sunt stocate.

-t Controlează afișarea datelor de timp, dacă sunt stocate într-o variabilă care utilizează un udunits
reprezentare conformă a timpului, cum ar fi „zile de la 1970-01-01” sau „secunde de la
2009-03-15 12:01:17', o variabilă identificată într-un atribut „limite” al unui astfel de timp
variabilă sau un atribut numeric al unei variabile de timp. Dacă se specifică această opțiune,
valorile datelor de timp sunt afișate mai degrabă ca șiruri de date și oră care pot fi citite de om
valori numerice, interpretate în termenii unui atribut de variabilă „calendar”, dacă
specificat. Pentru atributele numerice ale variabilelor de timp, valoarea timpului care poate fi citită de om
este afișat după valoarea reală, într-un comentariu CDL asociat. Calendar
valorile atributelor interpretate cu această opțiune includ valorile Convențiilor CF
`gregorian' sau `standard', `proleptic_gregorian', `noleap' sau `365_day', `all_leap'
sau „366_day”, „360_day” și „julian”.

-i La fel ca și opțiunea „-t”, cu excepția datelor de timp de ieșire ca șiruri de dată și oră cu ISO-8601
separator standard „T”, în loc de un gol.

-g grp1,...
Pentru fișierele netCDF-4, rezultatul va include valorile datelor numai pentru cele specificate
grupuri. Unul sau mai multe grupuri trebuie specificate după nume în lista delimitată prin virgulă
urmand aceasta optiune. Lista trebuie să fie un singur argument pentru comandă. Numitul
grupurile trebuie să fie grupuri netCDF valide în fișierul de intrare. Un grup într-un fișier netCDF-4
poate fi specificat cu un nume de cale absolut sau relativ. Utilizarea unei căi relative
name specifică toate numele grupurilor care se potrivesc din fișier. Implicit, fără aceasta
opțiunea și în absența celui -c or -h opțiuni, este de a include valorile datelor pentru
toate grupuri în ieșire.

-w Pentru numele de fișiere care solicită acces de la distanță folosind adrese URL DAP, accesați datele cu client-
stocarea în cache laterală a variabilelor întregi.

-x Ieșire XML (NcML) în loc de CDL. NcML nu include valorile datelor. NcML
Opțiunea de ieșire funcționează în prezent numai pentru datele modelului clasic netCDF.

EXEMPLE

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

ncdump -c foo.nc

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

ncdump -bc foo.nc > foo.cdl

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

ncdump -v uwind,vwind -p 3 foo.nc

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”:

ncdump -v omega -f fortran -n omega foo.nc > Z.cdl

Utilizați ncdump online folosind serviciile onworks.net