mincgen - Dalam talian di Awan

JADUAL:

NAMA

mincgen - Hasilkan fail MINC daripada fail CDL.

SINOPSIS

mincgen [-b] [-n] [-o nama fail_minc] input_file

DESCRIPTION

mincgen menghasilkan fail MINC. Input kepada mincgen ialah perihalan fail MINC dalam a
bahasa kecil yang dikenali sebagai CDL (Bahasa borang Data Biasa rangkaian), diterangkan di bawah. Jika tidak
pilihan ditentukan dalam memanggil mincgen, ia hanya menyemak sintaks CDL input
fail, menghasilkan mesej ralat untuk sebarang pelanggaran sintaks CDL. Pilihan lain boleh
digunakan untuk mencipta fail MINC yang sepadan.

mincgen boleh digunakan dengan program pendamping mincdump untuk melakukan beberapa operasi mudah
pada fail MINC. Contohnya, untuk menamakan semula dimensi dalam fail MINC, gunakan mincdump untuk mendapatkan
Versi CDL fail MINC, edit fail CDL untuk menukar nama dimensi dan
penggunaan mincgen untuk menjana fail MINC yang sepadan daripada fail CDL yang diedit.

PILIHAN

-b Buat fail MINC (perduaan). Sekiranya -o pilihan tiada, nama fail lalai akan
dibina daripada nama MINC (dinyatakan selepas netcdf or hdf5 kata kunci dalam
input) dengan menambahkan sambungan `.mnc'. Jika fail sudah wujud dengan
nama yang ditentukan, ia akan ditimpa.

-o nama fail_minc
Nama untuk fail MINC binari yang dibuat. Jika pilihan ini dinyatakan, ia membayangkan
"-b" pilihan. (Pilihan ini perlu kerana fail MINC tidak boleh ditulis
terus ke output standard, kerana output standard tidak boleh dicari.)

CONTOH

Semak sintaks fail CDL `foo.cdl':

mincgen foo.cdl

Daripada fail CDL `foo.cdl', hasilkan fail MINC binari yang setara bernama `x.mnc':

mincgen -o x.mnc foo.cdl

PENGGUNAAN

CDL Syntax Ringkasan
Di bawah ialah contoh sintaks CDL, menerangkan fail MINC dengan beberapa dimensi bernama
(xspace, yspace, dan zspace), pembolehubah (zspace, imej), atribut pembolehubah (julat_sah,
jenis tanda), dan beberapa data. Kata kunci CDL adalah dalam huruf tebal. (Contoh ini bertujuan untuk
menggambarkan sintaks; fail CDL sebenar akan mempunyai set atribut yang lebih lengkap
bahawa data akan lebih menggambarkan diri sendiri.)

netcdf foo { // contoh spesifikasi MINC dalam CDL

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

pembolehubah:
terapung xspace;
terapung yspace;
terapung zspace(zspace);
pendek imej(zspace,yspace,xspace);
dua kali ganda imej-min(zspace)
dua kali ganda imej-maks(zspace)

// atribut pembolehubah
imej:julat_sah = 0,5;
data:
image-min = -1,-1,-1,-1,-1;
imej-maks = 1,1,1,1,1;
imej =
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;
}

Semua pernyataan CDL ditamatkan dengan koma bertitik. Ruang, tab dan baris baharu boleh digunakan
bebas untuk kebolehbacaan. Komen boleh mengikut aksara `//' pada mana-mana baris.

Perihalan CDL terdiri daripada tiga bahagian pilihan: dimensi, pembolehubah, dan data,
bermula dengan kata kunci dimensi:, pemboleh ubah:, dan data, masing-masing. Pembolehubah
bahagian mungkin mengandungi berubah-ubah pengisytiharan and atribut tugasan.

MINC dimensi digunakan untuk menentukan bentuk satu atau lebih multidimensi
pembolehubah yang terkandung dalam fail MINC. Dimensi MINC mempunyai nama, saiz dan mungkin
beberapa sifat lain.

A berubah-ubah mewakili tatasusunan nilai berbilang dimensi daripada jenis yang sama. Pembolehubah mempunyai
nama, jenis data dan bentuk yang diterangkan oleh senarai dimensinya. Setiap pembolehubah boleh
juga telah dikaitkan sifat-sifat (lihat di bawah) serta nilai data. Nama, jenis data,
dan bentuk pembolehubah ditentukan oleh pengisytiharannya dalam berubah-ubah bahagian CDL
penerangan. Pembolehubah mungkin mempunyai nama yang sama dengan dimensi; oleh konvensyen seperti a
pembolehubah adalah satu dimensi dan mengandungi koordinat dimensi yang dinamakannya.
Dimensi tidak perlu mempunyai pembolehubah yang sepadan.

Sebuah netCDF atribut mengandungi maklumat tentang pembolehubah netCDF atau mengenai keseluruhan netCDF
set data. Atribut digunakan untuk menentukan sifat seperti unit, nilai khas, maksimum
dan nilai sah minimum, faktor penskalaan, offset dan parameter. Maklumat atribut
diwakili oleh nilai tunggal atau tatasusunan nilai. Sebagai contoh, "unit" ialah atribut
diwakili oleh tatasusunan aksara seperti "celsius". Atribut mempunyai kaitan
pembolehubah, nama, jenis data, panjang dan nilai. Berbeza dengan pembolehubah yang
bertujuan untuk data, atribut bertujuan untuk metadata (data tentang data).

Dalam CDL, atribut ditetapkan oleh pembolehubah dan nama atribut, dipisahkan oleh `:'. Ia
boleh diberikan global atribut tidak dikaitkan dengan mana-mana pembolehubah pada fail sebagai a
keseluruhan dengan menggunakan `:' sebelum nama atribut. Jenis data atribut dalam CDL ialah
diperoleh daripada jenis nilai yang diberikan kepadanya. Panjang atribut ialah
bilangan nilai data yang diberikan kepadanya, atau bilangan aksara dalam rentetan aksara
ditugaskan kepadanya. Berbilang nilai diberikan kepada atribut bukan aksara dengan mengasingkan
nilai dengan koma. Semua nilai yang diberikan kepada atribut mestilah daripada jenis yang sama.

Nama untuk dimensi, pembolehubah dan atribut CDL mesti bermula dengan abjad
aksara atau `_', dan aksara seterusnya mungkin abjad angka atau `_' atau `-'.

Pilihannya data bahagian spesifikasi CDL ialah tempat pembolehubah boleh dimulakan.
Sintaks permulaan adalah mudah: nama pembolehubah, tanda sama, dan koma-
senarai pemalar yang dihadkan (mungkin dipisahkan oleh ruang, tab dan baris baharu) ditamatkan
dengan koma bertitik. Untuk tatasusunan berbilang dimensi, dimensi terakhir berbeza-beza paling cepat. Justeru
susunan baris dan bukan susunan lajur digunakan untuk matriks. Jika lebih sedikit nilai dibekalkan
daripada yang diperlukan untuk mengisi pembolehubah, ia dilanjutkan dengan `nilai isian' yang bergantung kepada jenis,
yang boleh ditindih dengan membekalkan nilai untuk atribut pembolehubah ternama yang dinamakan
`_Nilai Isi'. Jenis pemalar tidak perlu sepadan dengan jenis yang diisytiharkan untuk pembolehubah;
paksaan dilakukan untuk menukar integer kepada titik terapung, sebagai contoh. Pemalar `_'
boleh digunakan untuk menetapkan nilai isian untuk pembolehubah.

Primitif Tarikh jenis
tangki aksara
bait 8-bit data
pendek Integer bertanda 16-bit
lama Integer bertanda 32-bit
int (sinonim dengan lama)
terapung IEEE titik terapung ketepatan tunggal (32 bit)
sebenar (sinonim dengan terapung)
dua kali ganda Titik terapung berketepatan ganda IEEE (64 bit)

Kecuali untuk jenis data tambahan bait dan kekurangan tidak ditandatangani, CDL menyokong perkara yang sama
jenis data primitif sebagai C. Nama untuk jenis data primitif adalah perkataan terpelihara dalam
CDL, jadi nama pembolehubah, dimensi dan atribut mestilah bukan nama jenis. Dalam
pengisytiharan, nama jenis boleh dinyatakan dalam huruf besar atau kecil.

Bait berbeza daripada aksara kerana ia bertujuan untuk menyimpan lapan bit data penuh,
dan bait sifar tidak mempunyai kepentingan khusus, seperti yang berlaku untuk data aksara.

Seluar pendek boleh menyimpan nilai antara -32768 dan 32767.

Long boleh memegang nilai antara -2147483648 dan 2147483647. int and integer diterima sebagai
sinonim untuk lama dalam pengisytiharan CDL. Kini terdapat platform dengan 64-bit
perwakilan untuk C longs, mungkin lebih baik menggunakan int sinonim untuk mengelakkan kekeliruan.

Terapung boleh menyimpan nilai antara kira-kira -3.4+38 dan 3.4+38. Perwakilan luar mereka ialah
sebagai IEEE 32-bit menormalkan nombor titik terapung ketepatan tunggal. sebenar diterima sebagai a
sinonim untuk terapung dalam pengisytiharan CDL.

Beregu boleh memegang nilai antara kira-kira -1.7+308 dan 1.7+308. Perwakilan luaran mereka
adalah sebagai nombor titik terapung berketepatan ganda 64-bit standard IEEE dinormalkan.

CDL Malang
Pemalar yang diberikan kepada atribut atau pembolehubah mungkin daripada mana-mana jenis MINC asas. The
sintaks untuk pemalar adalah serupa dengan sintaks C, kecuali jenis akhiran mesti dilampirkan
seluar pendek dan apungan untuk membezakannya daripada long dan double.

A bait pemalar diwakili oleh satu aksara atau jujukan pelarian berbilang aksara
disertakan dalam petikan tunggal. Sebagai contoh,
'a' // ASCII `a'
'\0' // bait sifar
'\n' // aksara baris baharu ASCII
'\33' // aksara melarikan diri ASCII (33 perlapanan)
'\x2b' // ASCII tambah (2b hex)
'\377' // 377 perlapanan = 255 perpuluhan, bukan ASCII

Pemalar aksara disertakan dalam petikan berganda. Tatasusunan aksara mungkin diwakili
sebagai rentetan yang disertakan dalam petikan berganda. Konvensyen melarikan diri rentetan C yang biasa dihormati.
Sebagai contoh
"a" // ASCII `a'
"Dua\nbaris\n" // rentetan 10 aksara dengan dua baris baharu terbenam
"a bell:\007" // rentetan yang mengandungi loceng ASCII
Ambil perhatian bahawa tatasusunan aksara "a" akan muat dalam pembolehubah satu elemen, kerana tidak
menamatkan aksara NULL diandaikan. Walau bagaimanapun, bait sifar dalam tatasusunan aksara ialah
ditafsirkan sebagai pengakhiran watak-watak penting oleh mincdump program, mengikuti
konvensyen C. Oleh itu, bait NULL tidak boleh dibenamkan dalam rentetan aksara
melainkan pada akhirnya: gunakan bait jenis data sebaliknya untuk tatasusunan bait yang mengandungi sifar
bait. MINC dan CDL tidak mempunyai jenis rentetan, tetapi hanya tatasusunan aksara panjang tetap, yang mungkin
menjadi pelbagai dimensi.

pendek pemalar integer bertujuan untuk mewakili kuantiti bertanda 16-bit. Borang
a pendek pemalar ialah pemalar integer dengan `s' atau `S' dilampirkan. Sekiranya pendek
pemalar bermula dengan `0', ia ditafsirkan sebagai oktal, kecuali jika ia bermula dengan `0x',
ia ditafsirkan sebagai pemalar heksadesimal. Sebagai contoh:
-2s // pendek -2
0123s // perlapanan
0x7ffs //perenambelasan

Panjang pemalar integer bertujuan untuk mewakili kuantiti bertanda 32-bit. Borang
a lama pemalar ialah pemalar integer biasa, walaupun ia boleh diterima untuk menambah an
`l' atau `L' pilihan. Sekiranya lama pemalar bermula dengan `0', ia ditafsirkan sebagai oktal,
kecuali jika ia bermula dengan `0x', ia ditafsirkan sebagai pemalar heksadesimal. Contoh
daripada sah lama pemalar termasuk:
-2
1234567890L
0123 // perlapanan
0x7ff // perenambelasan

Pemalar takat terapung jenis terapung sesuai untuk mewakili titik terapung
data dengan kira-kira tujuh digit bererti ketepatan. Bentuk a terapung pemalar ialah
sama seperti pemalar titik terapung C dengan `f' atau `F' yang dilampirkan. Contohnya
berikut semua boleh diterima terapung pemalar:
-2.0f
3.14159265358979f // akan dipotong kepada kurang ketepatan
1.f

Pemalar takat terapung jenis dua kali ganda sesuai untuk mewakili titik terapung
data dengan kira-kira enam belas digit bererti ketepatan. Bentuk a dua kali ganda pemalar ialah
sama dengan pemalar titik terapung C. `d' atau `D' pilihan boleh ditambah. Untuk
contoh berikut semua boleh diterima dua kali ganda pemalar:
-2.0
3.141592653589793
1.0 e-20
1d

Gunakan mincgen dalam talian menggunakan perkhidmatan onworks.net