mincgen - Online di Cloud

PROGRAM:

NAMA

mincgen - Menghasilkan file MINC dari file CDL.

RINGKASAN

mincgen [-b] [-n] [-o minc_namafile] masukan_file

DESKRIPSI

mincgen menghasilkan file MINC. Masukan ke mincgen adalah deskripsi file MINC di a
bahasa kecil yang dikenal sebagai CDL (Network Common Data form Language), dijelaskan di bawah ini. Jika tidak
opsi ditentukan dalam memanggil mincgen, itu hanya memeriksa sintaks dari input CDL
file, menghasilkan pesan kesalahan untuk setiap pelanggaran sintaks CDL. Pilihan lain bisa
digunakan untuk membuat file MINC yang sesuai.

mincgen dapat digunakan dengan program pendamping mincdump untuk melakukan beberapa operasi sederhana
pada file MINC. Misalnya, untuk mengganti nama dimensi dalam file MINC, gunakan mincdump untuk mendapatkan
Versi CDL dari file MINC, edit file CDL untuk mengubah nama dimensi, dan
menggunakan mincgen untuk menghasilkan file MINC yang sesuai dari file CDL yang diedit.

PILIHAN

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

-o minc_namafile
Nama untuk file MINC biner yang dibuat. Jika opsi ini ditentukan, itu menyiratkan bahwa
"-b". (Opsi ini diperlukan karena file MINC tidak dapat ditulis
langsung ke output standar, karena output standar tidak dapat dicari.)

CONTOH

Periksa sintaks file CDL `foo.cdl':

mincgen foo.cdl

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

mincgen -o x.mnc foo.cdl

PENGGUNAAN

CDL Sintaksis Kesimpulan
Di bawah ini adalah contoh sintaks CDL, menggambarkan file MINC dengan beberapa dimensi bernama
(xspace, yspace, dan zspace), variabel (zspace, image), atribut variabel (valid_range,
signtype), dan beberapa data. Kata kunci CDL dicetak tebal. (Contoh ini dimaksudkan untuk
mengilustrasikan sintaks; file CDL asli akan memiliki set atribut yang lebih lengkap, jadi
bahwa data akan lebih lengkap menggambarkan diri sendiri.)

netcdf foo { // contoh spesifikasi MINC di CDL

ukuran:
xspasi = 8;
yspasi = 8;
zspasi = 5;

variabel:
mengapung xspasi;
mengapung ruang y;
mengapung zspasi(zspasi);
pendek gambar(zspace,yspace,xspace);
dua kali lipat gambar-min(zspace)
dua kali lipat gambar-maks(zspace)

// atribut variabel
gambar:valid_range = 0,5;
data:
image-min = -1,-1,-1,-1,-1;
gambar-maks = 1,1,1,1,1;
gambar =
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;
zspasi = 0,2,3.5,7,10;
}

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.

MINC dimensi digunakan untuk menentukan bentuk satu atau lebih multidimensi
variabel yang terdapat dalam file MINC. Dimensi MINC memiliki nama, ukuran, dan mungkin
beberapa atribut lainnya.

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 tidak terkait dengan variabel apa pun ke file 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 dapat diinisialisasi.
Sintaks inisialisasi sederhana: nama variabel, tanda sama dengan, dan koma.
daftar konstanta yang dibatasi (mungkin dipisahkan oleh spasi, tab, dan baris baru) diakhiri
dengan titik koma. Untuk array multidimensi, dimensi terakhir bervariasi paling cepat. Dengan demikian
urutan baris daripada urutan kolom digunakan untuk matriks. Jika lebih sedikit nilai yang diberikan
daripada yang dibutuhkan untuk mengisi variabel, itu diperluas dengan `nilai isi' yang bergantung pada tipe,
yang dapat ditimpa dengan memberikan nilai untuk atribut variabel khusus bernama
`_Nilai Isi'. Jenis konstanta tidak harus cocok dengan jenis yang dideklarasikan untuk variabel;
pemaksaan dilakukan untuk mengubah bilangan bulat menjadi floating point, misalnya. Konstanta `_'
dapat digunakan untuk menentukan nilai isian untuk suatu variabel.

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.

Celana pendek dapat menyimpan nilai antara -32768 dan 32767.

Long dapat menyimpan nilai antara -2147483648 dan 2147483647. int dan bilangan bulat diterima sebagai
sinonim untuk panjang dalam deklarasi CDL. Sekarang ada platform dengan 64-bit
representasi untuk C longs, 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. 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.

CDL Konstanta
Konstanta yang ditetapkan ke atribut atau variabel dapat berupa salah satu dari tipe dasar MINC. NS
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 array karakter "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 mincdump program, berikut
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 nol
byte. MINC dan CDL tidak memiliki tipe string, tetapi hanya array karakter dengan panjang tetap, yang mungkin:
menjadi 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 mincgen online menggunakan layanan onworks.net