ncdump - Dalam talian dalam Awan

JADUAL:

NAMA

ncdump - Tukar fail netCDF kepada bentuk teks (CDL)

SINOPSIS

ncdump [-chistxw] [-v var1,...] [-b lang] [-f lang] [-l len] [-n nama] [-hlm
f_digit[,d_digit]] [-g grp1,...] fail

ncdump -k fail

DESCRIPTION

. ncdump utiliti menjana perwakilan teks fail netCDF yang ditentukan pada standard
output, secara pilihan mengecualikan beberapa atau semua data pembolehubah dalam output. Teks
representasi adalah dalam bentuk yang dipanggil CDL (network Common Data form Language) yang boleh
dilihat, disunting atau dijadikan sebagai input kepada ncgen, program pendamping yang boleh menjana binari
fail netCDF daripada fail CDL. Oleh itu ncgen and ncdump boleh digunakan sebagai songsang untuk berubah
perwakilan data antara perwakilan binari dan teks. Lihat ncgen dokumentasi
untuk penerangan tentang perwakilan CDL dan netCDF.

ncdump juga boleh digunakan untuk menentukan jenis fail netCDF yang digunakan (varian mana
format fail netCDF) dengan pilihan -k.

Jika sokongan DAP didayakan apabila ncdump telah dibina, nama fail mungkin menentukan URL DAP.
Ini membenarkan ncdump untuk mengakses sumber data daripada pelayan DAP, termasuk data dalam lain
format daripada netCDF. Apabila digunakan dengan URL DAP, ncdump menunjukkan terjemahan daripada DAP
model data kepada model data netCDF.

ncdump juga boleh digunakan sebagai pelayar ringkas untuk fail data netCDF, untuk memaparkan
nama dimensi dan panjang; nama pembolehubah, jenis dan bentuk; nama atribut dan
nilai; dan secara pilihan, nilai data untuk semua pembolehubah atau pembolehubah terpilih dalam a
fail netCDF. Untuk fail netCDF-4, kumpulan dan jenis yang ditentukan pengguna juga disertakan dalam
keluaran ncdump.

ncdump menggunakan `_' untuk mewakili nilai data yang sama dengan atribut `_FillValue' untuk
pembolehubah, bertujuan untuk mewakili data yang belum ditulis. Jika pembolehubah mempunyai
tiada atribut `_FillValue', nilai isian lalai untuk jenis pembolehubah digunakan melainkan jika
pembolehubah adalah daripada jenis bait.

ncdump mentakrifkan format paparan lalai yang digunakan untuk setiap jenis data netCDF, tetapi ini boleh
ditukar jika atribut `C_format' ditakrifkan untuk pembolehubah netCDF. Dalam kes ini, ncdump
akan menggunakan atribut `C_format' untuk memformat setiap nilai. Sebagai contoh, jika floating-point
data untuk pembolehubah netCDF `Z' diketahui tepat kepada hanya tiga digit bererti,
adalah sesuai untuk menggunakan atribut pembolehubah

Z:C_format = "%.3g"

PILIHAN

-c Tunjukkan nilai bagi menyelaraskan pembolehubah (pembolehubah 1D dengan nama yang sama seperti
dimensi) serta pengisytiharan semua dimensi, pembolehubah, atribut
nilai, kumpulan dan jenis yang ditentukan pengguna. Nilai data pembolehubah bukan koordinat
tidak termasuk dalam output. Ini biasanya pilihan yang paling sesuai untuk digunakan
untuk melihat secara ringkas struktur dan kandungan fail netCDF.

-h Tunjukkan hanya header maklumat dalam output, iaitu output hanya
pengisytiharan untuk dimensi, pembolehubah, atribut, kumpulan dan ditentukan pengguna
jenis fail input, tetapi tiada nilai data untuk sebarang pembolehubah. Outputnya ialah
sama dengan menggunakan -c pilihan kecuali bahawa nilai pembolehubah koordinat ialah
tidak termasuk. (Paling banyak satu daripada -c or -h pilihan mungkin ada.)

-v var1,...
Output akan memasukkan nilai data untuk pembolehubah yang ditentukan, sebagai tambahan kepada
pengisytiharan semua dimensi, pembolehubah dan atribut. Satu atau lebih pembolehubah
mesti dinyatakan dengan nama dalam senarai dipisahkan koma mengikut pilihan ini. The
list mestilah satu hujah kepada arahan, oleh itu tidak boleh mengandungi unescaped
kosong atau aksara ruang putih lain. Pembolehubah yang dinamakan mestilah netCDF yang sah
pembolehubah dalam fail input. Pembolehubah dalam kumpulan dalam fail netCDF-4 mungkin
ditentukan dengan nama laluan mutlak, seperti `/GroupA/GroupA2/var'. Penggunaan a
nama laluan relatif seperti `var' atau `grp/var' menentukan semua nama pembolehubah yang sepadan
dalam fail. Lalai, tanpa pilihan ini dan jika tiada -c or -h
pilihan, adalah untuk memasukkan nilai data untuk semua pembolehubah dalam output.

-b [c|f]
Anotasi ringkas dalam bentuk ulasan CDL (teks bermula dengan aksara
``//'') akan dimasukkan ke dalam bahagian data output untuk setiap `baris' data,
untuk membantu mengenal pasti nilai data untuk pembolehubah pelbagai dimensi. Jika lang bermula dengan
`C' atau `c', maka konvensyen bahasa C akan digunakan (indeks berasaskan sifar, terakhir
dimensi berbeza-beza terpantas). Jika lang bermula dengan `F' atau `f', kemudian bahasa Fortran
konvensyen akan digunakan (indeks berasaskan satu, dimensi pertama berbeza-beza terpantas). Dalam
mana-mana kes, data akan dibentangkan dalam susunan yang sama; hanya anotasi
akan berbeza. Pilihan ini mungkin berguna untuk menyemak imbas melalui volum yang besar
data berbilang dimensi.

-f [c|f]
Anotasi penuh dalam bentuk ulasan CDL mengekori (teks bermula dengan
aksara ``//'') untuk setiap nilai data (kecuali aksara individu dalam aksara
tatasusunan) akan dimasukkan ke dalam bahagian data. Jika lang bermula dengan `C' atau `c', kemudian
Konvensyen bahasa C akan digunakan. Jika lang bermula dengan `F' atau `f', kemudian Fortran
konvensyen bahasa akan digunakan. Dalam mana-mana kes, data akan dibentangkan dalam
susunan yang sama; hanya anotasi akan berbeza. Pilihan ini mungkin berguna untuk
menyalurkan data ke dalam penapis lain, kerana setiap nilai data muncul pada baris yang berasingan,
dikenal pasti sepenuhnya. (Paling banyak satu daripada pilihan '-b' atau '-f' mungkin ada.)

-l panjang
Menukar panjang baris maksimum lalai (80) yang digunakan dalam memformat senarai bukan-
nilai data aksara.

-n nama
CDL memerlukan nama untuk fail netCDF, untuk digunakan oleh ncgen -b dalam menjana lalai
nama fail netCDF. Secara lalai, ncdump membina nama ini daripada komponen terakhir
nama fail fail netCDF input dengan menanggalkan sebarang sambungan yang ada padanya.
Menggunakan -n pilihan untuk menentukan nama yang berbeza. Walaupun nama fail output digunakan
by ncgen -b boleh ditentukan, mungkin bijak untuk mempunyai ncdump tukar nama lalai
untuk mengelakkan secara tidak sengaja menimpa fail netCDF yang berharga apabila menggunakan ncdump,
mengedit fail CDL yang terhasil, dan menggunakan ncgen -b untuk menjana fail netCDF baharu
daripada fail CDL yang diedit.

-p angka_apung[,angka_ganda]
Menentukan ketepatan lalai (bilangan digit bererti) untuk digunakan dalam paparan
titik terapung atau nilai data ketepatan berganda untuk atribut dan pembolehubah. Jika
ditentukan, nilai ini mengatasi nilai atribut C_format, jika ada, untuk a
pembolehubah. Data titik terapung akan dipaparkan dengan angka_apung ketara
digit. Jika dua_digit juga ditentukan, nilai ketepatan dua kali akan menjadi
dipaparkan dengan banyak digit bererti itu. Sekiranya tiada -p
spesifikasi, data titik terapung dan ketepatan dua kali dipaparkan dengan 7 dan
15 digit bererti masing-masing. Fail CDL boleh dibuat lebih kecil jika kurang
ketepatan diperlukan. Jika kedua-dua titik terapung dan ketepatan berganda ditentukan,
kedua-dua nilai mesti kelihatan dipisahkan dengan koma (tiada kosong) sebagai satu argumen untuk
perintah itu. (Untuk mewakili setiap bit ketepatan terakhir dalam fail CDL untuk semua
nilai titik terapung yang mungkin diperlukan -p 9,17.)

-k Tunjukkan jenis fail netCDF rujukan nama laluan, salah satu daripada `klasik', `64-bit
offset',`netCDF-4' atau `netCDF-4 classic model'. Sebelum versi 3.6, ada
hanya satu jenis fail netCDF, ditetapkan sebagai `klasik' (juga dikenali sebagai varian format
1). Sokongan fail besar memperkenalkan satu lagi varian format, yang ditetapkan sebagai
`64-bit offset' (dikenali sebagai varian format 2). NetCDF-4, menggunakan varian ketiga daripada
format, `netCDF-4' (varian format 3). Satu lagi varian format, ditetapkan
`model klasik netCDF-4' (varian format 4), terhad kepada ciri yang disokong oleh
model data netCDF-3 tetapi diwakili menggunakan format HDF5, supaya an
program netCDF-3 yang tidak diubah suai boleh membaca atau menulis fail hanya dengan memaut semula dengan
perpustakaan netCDF-4. Output rentetan dengan menggunakan pilihan `-k' boleh disediakan sebagai
nilai pilihan `-k' kepada ncgen(1) untuk menentukan dengan tepat jenis netCDF
fail untuk dijana, apabila anda ingin mengatasi lalai yang disimpulkan daripada CDL.

-s Keluarkan atribut maya khas yang menyediakan maklumat berkaitan prestasi
tentang format fail dan sifat pembolehubah untuk data netCDF-4. Istimewa ini
atribut maya sebenarnya bukan sebahagian daripada data, ia hanya mudah
cara untuk memaparkan pelbagai sifat data dalam CDL (dan akhirnya NcML).
Ia termasuk `_ChunkSizes', `_DeflateLevel', `_Endianness', `_Fletcher32',
`_Format', `_NoFill', `_Shuffle' dan `_Storage'. `_ChunkSizes' ialah senarai bongkah
saiz bagi setiap dimensi pembolehubah. `_DeflateLevel' ialah integer antara 0
dan 9 inklusif jika pemampatan telah ditentukan untuk pembolehubah. `_Endianness'
adalah sama ada `kecil' atau `besar', bergantung pada cara pembolehubah disimpan semasa mula-mula
bertulis. `_Fletcher32' adalah `benar' jika sifat checksum ditetapkan untuk
pembolehubah. `_Format' ialah atribut global yang menentukan varian format netCDF,
salah satu daripada `klasik', `mengimbangi 64-bit', `netCDF-4' atau `model klasik netCDF-4'.
`_NoFill' adalah `true' jika sifat NoFill yang berterusan telah ditetapkan untuk pembolehubah apabila
ia telah ditakrifkan. `_Shuffle' adalah `true' jika penggunaan penapis shuffle telah ditentukan
untuk pembolehubah. `_Storage' ialah `bersebelahan' atau `chunked', bergantung pada cara
data pembolehubah disimpan.

-t Mengawal paparan data masa, jika disimpan dalam pembolehubah yang menggunakan udunits
perwakilan masa yang mematuhi seperti `hari sejak 1970-01-01' atau `saat sejak
2009-03-15 12:01:17', pembolehubah yang dikenal pasti dalam atribut "sempadan" pada masa sedemikian
pembolehubah, atau atribut berangka pembolehubah masa. Jika pilihan ini dinyatakan,
nilai data masa dipaparkan sebagai rentetan tarikh-masa yang boleh dibaca manusia dan bukannya
nilai berangka, ditafsirkan dari segi atribut pembolehubah `kalendar', jika
ditentukan. Untuk atribut berangka pembolehubah masa, nilai masa boleh dibaca manusia
dipaparkan selepas nilai sebenar, dalam ulasan CDL yang berkaitan. Kalendar
nilai atribut yang ditafsirkan dengan pilihan ini termasuk nilai Konvensyen CF
`gregorian' atau `standard', `proleptic_gregorian', `noleap' atau `365_day', `all_leap'
atau `366_hari', `360_hari' dan `julian'.

-i Sama seperti pilihan '-t', kecuali data masa keluaran sebagai rentetan tarikh-masa dengan ISO-8601
pemisah standard 'T', bukannya kosong.

-g grp1,...
Untuk fail netCDF-4, output akan termasuk nilai data hanya untuk yang ditentukan
kumpulan. Satu atau lebih kumpulan mesti dinyatakan mengikut nama dalam senarai yang dipisahkan koma
mengikuti pilihan ini. Senarai itu mestilah satu hujah kepada arahan. Yang bernama
kumpulan mestilah kumpulan netCDF yang sah dalam fail input. Kumpulan dalam fail netCDF-4
boleh ditentukan dengan nama laluan mutlak atau relatif. Penggunaan laluan relatif
nama menentukan semua nama kumpulan yang sepadan dalam fail. Lalai, tanpa ini
pilihan dan jika tiada -c or -h pilihan, adalah untuk memasukkan nilai data untuk
semua kumpulan dalam output.

-w Untuk nama fail yang meminta capaian jauh menggunakan URL DAP, capai data dengan klien-
caching sisi keseluruhan pembolehubah.

-x Keluaran XML (NcML) bukannya CDL. NcML tidak termasuk nilai data. NcML
pilihan output pada masa ini hanya berfungsi untuk data model klasik netCDF.

CONTOH

Lihat struktur data dalam fail netCDF `foo.nc':

ncdump -c foo.nc

Hasilkan versi CDL beranotasi bagi struktur dan data dalam fail netCDF `foo.nc',
menggunakan pengindeksan gaya C untuk anotasi:

ncdump -bc foo.nc > foo.cdl

Data keluaran untuk pembolehubah `uwind' dan `vwind' sahaja daripada fail netCDF `foo.nc', dan
tunjukkan data titik terapung dengan hanya tiga digit bererti ketepatan:

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

Hasilkan penyenaraian beranotasi sepenuhnya (satu nilai data setiap baris) bagi data untuk pembolehubah
`omega', menggunakan konvensyen Fortran untuk indeks, dan menukar nama set data netCDF dalam
fail CDL yang terhasil ke `omega':

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

Gunakan ncdump dalam talian menggunakan perkhidmatan onworks.net