ncgen-hdf - Online di Cloud

PROGRAM:

NAMA

ncgen - Dari file CDL, buat file netCDF, program C, atau program Fortran

RINGKASAN

ncgen [-b] [-c] [-f] [-n] [-o berkas keluaran] masukan_file

DESKRIPSI

ncgen menghasilkan file netCDF, atau kode sumber C atau Fortran untuk membuat file netCDF.
Masukan ke ncgen adalah deskripsi file netCDF dalam bahasa kecil yang dikenal sebagai CDL
(Bahasa bentuk Data Umum jaringan), dijelaskan di bawah ini. Jika tidak ada opsi yang ditentukan dalam
memohon ncgen, itu hanya memeriksa sintaks file CDL input, menghasilkan kesalahan
pesan untuk setiap pelanggaran sintaks CDL. Opsi lain dapat digunakan untuk membuat
file netCDF yang sesuai, untuk menghasilkan program C yang menggunakan antarmuka netCDF C untuk
buat file netCDF, atau untuk membuat program Fortran yang menggunakan netCDF Fortran
antarmuka untuk membuat file netCDF yang sama.

ncgen dapat digunakan dengan program pendamping ncdump untuk melakukan beberapa operasi sederhana pada
file netCDF. Misalnya, untuk mengganti nama dimensi dalam file netCDF, gunakan ncdump untuk mendapatkan
Versi CDL dari file netCDF, edit file CDL untuk mengubah nama dimensi,
Dan gunakan ncgen untuk menghasilkan file netCDF yang sesuai dari file CDL yang diedit.

PILIHAN

-b Buat file netCDF (biner). jika -o opsi tidak ada, nama file default
akan dibangun dari nama netCDF (ditentukan setelah netcdf kata kunci di
input) dengan menambahkan ekstensi `.nc'. Jika file sudah ada dengan
nama tertentu, itu akan ditimpa.

-c Menghasilkan C kode sumber yang akan membuat file netCDF yang cocok dengan netCDF
spesifikasi. Kode sumber C ditulis ke output standar.

-f Menghasilkan Fortran kode sumber yang akan membuat file netCDF yang cocok dengan netCDF
spesifikasi. Kode sumber Fortran ditulis ke keluaran standar.

-o berkas keluaran
Nama untuk file netCDF yang dibuat. Jika opsi ini ditentukan, ini menyiratkan "-b"
pilihan. (Opsi ini diperlukan karena file netCDF tidak dapat ditulis secara langsung
ke output standar, karena output standar tidak dapat dicari.)

-n Seperti -b pilihan, kecuali membuat file netCDF dengan ekstensi `.cdf' usang
alih-alih ekstensi `.nc', dengan tidak adanya nama file keluaran yang ditentukan oleh
itu -O pilihan. Opsi ini hanya didukung untuk kompatibilitas mundur.

CONTOH

Periksa sintaks file CDL `foo.cdl':

ncgen foo.cdl

Dari file CDL `foo.cdl', buat file netCDF biner yang setara bernama `x.nc':

ncgen -o x.nc foo.cdl

Dari file CDL `foo.cdl', buat program C yang berisi fungsi netCDF
pemanggilan yang diperlukan untuk membuat file netCDF biner setara bernama `x.nc':

ncgen -c -o x.nc foo.cdl

PENGGUNAAN

CDL Sintaksis Kesimpulan
Di bawah ini adalah contoh sintaks CDL, menggambarkan file netCDF dengan beberapa dimensi bernama:
(lat, lon, and time), variabel (Z, t, p, rh, lat, lon, time), atribut variabel (unit,
long_name, valid_range, _FillValue), dan beberapa data. Kata kunci CDL dicetak tebal. (Ini
contoh dimaksudkan untuk menggambarkan sintaks; file CDL asli akan lebih lengkap
set atribut sehingga data akan lebih lengkap menggambarkan diri sendiri.)

netcdf foo { // contoh spesifikasi netCDF di CDL

ukuran:
lat = 10, lon = 5, waktu = tak terbatas ;

variabel:
panjang lat(lat), lon(lon), waktu(waktu);
mengapung Z(waktu,lat,lon), t(waktu,lat,lon);
dua kali lipat p(waktu, bujur, bujur);
panjang rh(waktu, bujur, bujur);

// atribut variabel
lat:long_name = "lintang";
lat:satuan = "derajat_utara";
lon:long_name = "bujur";
lon:unit = "derajat_timur";
waktu:unit = "detik sejak 1992-1-1 00:00:00";
Z:satuan = "meter geopotensial";
Z: rentang_valid = 0, 5000.;
p:_Nilai Isian = -9999.;
rh:_NilaiIsi = -1;

data:
lintang = 0, 10, 20, 30, 40, 50, 60, 70, 80, 90;
lon = -140, -118, -96, -84, -52;
}

Semua pernyataan CDL diakhiri dengan titik koma. Spasi, tab, dan baris baru dapat digunakan
bebas untuk dibaca. Komentar dapat mengikuti karakter `//' pada baris mana pun.

Deskripsi CDL terdiri dari tiga bagian opsional: ukuran, variabel, dan data,
dimulai dengan kata kunci ukuran:, variabel:, dan data, masing-masing. Variabel
bagian mungkin berisi variabel deklarasi dan atribut tugas.

NetCDF dimensi digunakan untuk menentukan bentuk satu atau lebih multidimensi
variabel yang terkandung dalam file netCDF. Dimensi netCDF memiliki nama dan ukuran. Pada
sebagian besar satu dimensi dalam file netCDF dapat memiliki tak terbatas ukuran, yang berarti variabel
menggunakan dimensi ini dapat bertambah panjangnya (seperti nomor catatan dalam file).

A variabel mewakili array multidimensi dari nilai-nilai dari jenis yang sama. Sebuah variabel memiliki
nama, tipe data, dan bentuk yang dijelaskan oleh daftar dimensinya. Setiap variabel mungkin
juga memiliki asosiasi atribut (lihat di bawah) serta nilai data. Nama, tipe data,
dan bentuk variabel ditentukan oleh deklarasinya di variabel bagian dari CDL
keterangan. Variabel mungkin memiliki nama yang sama dengan dimensi; dengan konvensi seperti
variabel adalah satu dimensi dan berisi koordinat dimensi yang dinamainya.
Dimensi tidak perlu memiliki variabel yang sesuai.

NetCDF atribut berisi informasi tentang variabel netCDF atau tentang keseluruhan netCDF
Himpunan data. Atribut digunakan untuk menentukan properti seperti unit, nilai khusus, maksimum
dan nilai valid minimum, faktor penskalaan, offset, dan parameter. Informasi atribut
diwakili oleh nilai tunggal atau array nilai. Misalnya, "unit" adalah atribut
diwakili oleh array karakter seperti "celsius". Sebuah atribut memiliki asosiasi
variabel, nama, tipe data, panjang, dan nilai. Berbeda dengan variabel yang
ditujukan untuk data, atribut ditujukan untuk metadata (data tentang data).

Dalam CDL, atribut ditunjuk oleh variabel dan nama atribut, dipisahkan oleh `:'. Dia
mungkin untuk ditugaskan global atribut yang tidak terkait dengan variabel apa pun ke netCDF sebagai
keseluruhan dengan menggunakan `:' sebelum nama atribut. Tipe data dari sebuah atribut dalam CDL adalah
diturunkan dari jenis nilai yang diberikan padanya. Panjang suatu atribut adalah
jumlah nilai data yang ditetapkan untuknya, atau jumlah karakter dalam string karakter
ditugaskan untuk itu. Beberapa nilai ditetapkan ke atribut non-karakter dengan memisahkan
nilai dengan koma. Semua nilai yang ditetapkan ke atribut harus bertipe sama.

Nama untuk dimensi, variabel, dan atribut CDL harus dimulai dengan abjad
karakter atau `_', dan karakter berikutnya dapat berupa alfanumerik atau `_' atau `-'.

Opsional data bagian dari spesifikasi CDL adalah tempat variabel netCDF mungkin
diinisialisasi. Sintaks inisialisasi sederhana: nama variabel, tanda sama dengan,
dan daftar konstanta yang dipisahkan koma (mungkin dipisahkan oleh spasi, tab, dan baris baru)
diakhiri dengan titik koma. Untuk array multi-dimensi, dimensi terakhir bervariasi
tercepat. Jadi urutan baris daripada urutan kolom digunakan untuk matriks. Jika lebih sedikit nilai
dipasok daripada yang dibutuhkan untuk mengisi variabel, itu diperluas dengan tipe-tergantung
`isi nilai', yang dapat ditimpa dengan memberikan nilai untuk variabel yang dibedakan
atribut bernama `_FillValue'. Jenis konstanta tidak harus cocok dengan jenis yang dideklarasikan untuk
sebuah variabel; pemaksaan dilakukan untuk mengubah bilangan bulat menjadi floating point, misalnya.

Primitif Data jenis
tangki karakter
byte Data 8-bit
pendek Bilangan bulat bertanda 16-bit
panjang Bilangan bulat bertanda 32-bit
int (sinonim dengan panjang)
mengapung Titik mengambang presisi tunggal IEEE (32 bit)
nyata (sinonim dengan mengapung)
dua kali lipat Titik mengambang presisi ganda IEEE (64 bit)

Kecuali untuk tipe data yang ditambahkan byte dan kurangnya unsigned, CDL mendukung hal yang sama
tipe data primitif sebagai C. Nama untuk tipe data primitif adalah kata-kata yang dicadangkan dalam
CDL, jadi nama variabel, dimensi, dan atribut tidak boleh berupa nama tipe. Di dalam
deklarasi, nama tipe dapat ditentukan dalam huruf besar atau kecil.

Bytes berbeda dari karakter karena mereka dimaksudkan untuk menampung delapan bit data penuh,
dan byte nol tidak memiliki arti khusus, seperti halnya untuk data karakter. ncgen
mengkonversi byte deklarasi untuk tangki deklarasi dalam kode output C dan ke
tidak standar BYTE deklarasi dalam kode Fortran keluaran.

Celana pendek dapat menyimpan nilai antara -32768 dan 32767. ncgen mengkonversi pendek deklarasi untuk
pendek deklarasi dalam kode output C dan ke yang tidak standar BULAT*2 deklarasi dalam
keluaran kode Fortran.

Long dapat menyimpan nilai antara -2147483648 dan 2147483647. ncgen mengkonversi panjang
deklarasi untuk panjang deklarasi dalam kode output C dan untuk BILANGAN BULAT deklarasi dalam
keluaran kode Fortran. int dan bilangan bulat diterima sebagai sinonim untuk panjang dalam CDL
deklarasi. Sekarang ada platform dengan representasi 64-bit untuk long C, itu
mungkin lebih baik menggunakan int sinonim untuk menghindari kebingungan.

Float dapat menyimpan nilai antara sekitar -3.4+38 dan 3.4+38. Representasi eksternal mereka adalah
sebagai IEEE 32-bit menormalkan angka floating point presisi tunggal. ncgen mengkonversi mengapung
deklarasi untuk mengapung deklarasi dalam kode output C dan untuk NYATA deklarasi dalam output
kode Fortran. nyata diterima sebagai sinonim untuk mengapung dalam deklarasi CDL.

Ganda dapat menyimpan nilai antara sekitar -1.7+308 dan 1.7+308. Representasi eksternal mereka
adalah sebagai standar IEEE 64-bit yang dinormalisasi angka floating point presisi ganda. ncgen
mengkonversi dua kali lipat deklarasi untuk dua kali lipat deklarasi dalam kode output C dan untuk DUA KALI LIPAT
KETEPATAN deklarasi dalam kode Fortran keluaran.

CDL Konstanta
Konstanta yang ditetapkan ke atribut atau variabel dapat berupa salah satu dari jenis netCDF dasar.
Sintaks untuk konstanta mirip dengan sintaks C, kecuali bahwa sufiks tipe harus
ditambahkan ke celana pendek dan pelampung untuk membedakannya dari long dan double.

A byte konstanta diwakili oleh satu karakter atau beberapa karakter escape sequence
terlampir dalam tanda kutip tunggal. Sebagai contoh,
'a' // ASCII `a'
'\0' // satu byte nol
'\n' // karakter baris baru ASCII
'\33' // karakter escape ASCII (33 oktal)
'\x2b' // ASCII plus (2b heksagonal)
'\377' // 377 oktal = 255 desimal, non-ASCII

Konstanta karakter diapit oleh tanda kutip ganda. Array karakter dapat diwakili
sebagai string yang diapit tanda kutip ganda. Konvensi pelarian string C yang biasa dihormati.
Misalnya
"a" // ASCII `a'
"Dua\nbaris\n" // string 10 karakter dengan dua baris baru yang disematkan
"a bell:\007" // string yang berisi lonceng ASCII
Perhatikan bahwa larik karakter netCDF "a" akan cocok dengan variabel satu elemen, karena tidak ada
penghentian karakter NULL diasumsikan. Namun, nol byte dalam array karakter adalah
ditafsirkan sebagai akhir dari karakter penting oleh ncdump program, mengikuti
konvensi C. Oleh karena itu, byte NULL tidak boleh disematkan dalam string karakter kecuali
di akhir: gunakan byte tipe data sebagai gantinya untuk array byte yang berisi byte nol.
NetCDF dan CDL tidak memiliki tipe string, tetapi hanya array karakter dengan panjang tetap, yang mungkin:
multidimensi.

pendek konstanta integer dimaksudkan untuk mewakili kuantitas bertanda 16-bit. Formulir
dari pendek konstanta adalah konstanta bilangan bulat dengan `s' atau `S' ditambahkan. Jika sebuah pendek
konstanta dimulai dengan `0', itu ditafsirkan sebagai oktal, kecuali jika dimulai dengan `0x',
itu ditafsirkan sebagai konstanta heksadesimal. Sebagai contoh:
-2s // singkat -2
0123s // oktal
0x7ffs //heksadesimal

Panjang konstanta integer dimaksudkan untuk mewakili kuantitas bertanda 32-bit. Formulir
dari panjang konstanta adalah konstanta bilangan bulat biasa, meskipun dapat diterima untuk menambahkan
opsional `l' atau `L'. Jika sebuah panjang konstanta dimulai dengan `0', itu ditafsirkan sebagai oktal,
kecuali jika dimulai dengan `0x', itu ditafsirkan sebagai konstanta heksadesimal. Contoh
sah panjang konstanta meliputi:
-2
1234567890L
0123 // oktal
0x7ff // heksadesimal

Konstanta titik mengambang tipe mengapung sesuai untuk mewakili floating point
data dengan presisi sekitar tujuh digit signifikan. Bentuk dari mengapung konstan adalah
sama dengan konstanta floating point C dengan `f' atau `F' ditambahkan. Misalnya
berikut ini semua dapat diterima mengapung konstanta:
-2.0f
3.14159265358979f // akan dipotong menjadi kurang presisi
1.f

Konstanta titik mengambang tipe dua kali lipat sesuai untuk mewakili floating point
data dengan sekitar enam belas digit signifikan presisi. Bentuk dari dua kali lipat konstan adalah
sama dengan konstanta titik mengambang C. `d' atau `D' opsional dapat ditambahkan. Untuk
contoh berikut ini semua dapat diterima dua kali lipat konstanta:
-2.0
3.141592653589793
1.0e-20
1d

Gunakan ncgen-hdf online menggunakan layanan onworks.net