ncgen-hdf - Bulutta Çevrimiçi

Program:

ADI

ncgen - Bir CDL dosyasından bir netCDF dosyası, bir C programı veya bir Fortran programı oluşturun

SİNOPSİS

ncgen [-b] [-c] [-f] [-n] [-o çıktı dosyası] giriş dosyası

TANIM

ncgen bir netCDF dosyası oluşturmak için bir netCDF dosyası veya C veya Fortran kaynak kodu oluşturur.
giriş ncgen CDL olarak bilinen küçük bir dilde bir netCDF dosyasının açıklamasıdır.
(ağ Ortak Veri form Dili), aşağıda açıklanmıştır. Hiçbir seçenek belirtilmemişse
çağıran ncgen, yalnızca giriş CDL dosyasının sözdizimini kontrol ederek hata üretir
CDL sözdiziminin herhangi bir ihlali için mesajlar. oluşturmak için diğer seçenekler kullanılabilir.
için netCDF C arabirimini kullanan bir C programı oluşturmak için ilgili netCDF dosyası
netCDF dosyasını oluşturmak veya netCDF Fortran'ı kullanan bir Fortran programı oluşturmak için
aynı netCDF dosyasını oluşturmak için arayüz.

ncgen tamamlayıcı program ile kullanılabilir ncdump bazı basit işlemleri gerçekleştirmek için
netCDF dosyaları. Örneğin, bir netCDF dosyasındaki bir boyutu yeniden adlandırmak için şunu kullanın: ncdump Bir almak için
NetCDF dosyasının CDL sürümü, boyutların adını değiştirmek için CDL dosyasını düzenleyin,
ve kullan ncgen Düzenlenen CDL dosyasından ilgili netCDF dosyasını oluşturmak için.

SEÇENEKLER

-b Bir (ikili) netCDF dosyası oluşturun. Eğer -o seçenek yok, varsayılan dosya adı
netCDF adından oluşturulacaktır ( netcdf anahtar kelime
input) `.nc' uzantısını ekleyerek. ile bir dosya zaten mevcutsa
belirtilen ad, üzerine yazılacaktır.

-c Oluşturmak C netCDF ile eşleşen bir netCDF dosyası oluşturacak kaynak kodu
Şartname. C kaynak kodu standart çıktıya yazılır.

-f Oluşturmak Fortran netCDF ile eşleşen bir netCDF dosyası oluşturacak kaynak kodu
Şartname. Fortran kaynak kodu standart çıktıya yazılır.

-o çıktı dosyası
Oluşturulan netCDF dosyasının adı. Bu seçenek belirtilirse, "-b"
seçenek. (Bu seçenek gereklidir çünkü netCDF dosyaları doğrudan yazılamaz.
standart çıktı aranabilir olmadığından standart çıktıya.)

-n Facebok sayfasını beğenin : -b seçeneği, eski `.cdf' uzantısına sahip netCDF dosyası oluşturması dışında
tarafından belirtilen bir çıktı dosya adının yokluğunda, `.nc' uzantısı yerine
the -O seçenek. Bu seçenek yalnızca geriye dönük uyumluluk için desteklenir.

ÖRNEKLER

CDL dosyasının sözdizimini kontrol edin `foo.cdl':

ncgen foo.cdl

CDL dosyasından `foo.cdl', `adlı eşdeğer bir ikili netCDF dosyası oluşturunx.nc':

ncgen -o x.nc foo.cdl

CDL dosyasından `foo.cdl', netCDF işlevini içeren bir C programı oluşturun
` adlı eşdeğer bir ikili netCDF dosyası oluşturmak için gerekli çağrılarx.nc':

ncgen -c -o x.nc foo.cdl

KULLANIM

CDL Sözdizimi ÖZET
Aşağıda, birkaç adlandırılmış boyuta sahip bir netCDF dosyasını tanımlayan bir CDL sözdizimi örneği verilmiştir.
(enlem, boylam ve zaman), değişkenler (Z, t, p, rh, enlem, boylam, zaman), değişken nitelikler (birimler,
long_name, valid_range, _FillValue) ve bazı veriler. CDL anahtar sözcükleri kalın harflerle yazılmıştır. (Bu
örnek, sözdizimini açıklamaya yöneliktir; gerçek bir CDL dosyası daha eksiksiz olurdu
verilerin daha eksiksiz bir şekilde kendini tanımlaması için bir dizi nitelik.)

netcdf foo { // CDL'de örnek bir netCDF özelliği

boyutlar:
enlem = 10, boylam = 5, zaman = sınırsız ;

değişkenler:
ve kazandırdı enlem(lat), boylam(boylam), zaman(zaman);
şamandıra Z(zaman, enlem, boylam), t(zaman, enlem, boylam);
çift p(zaman, enlem, boylam);
ve kazandırdı rh(zaman, enlem, boylam);

// değişken nitelikler
lat:long_name = "enlem";
lat:birimler = "derece_kuzey";
lon:long_name = "boylam";
lon:units = "derece_doğu";
zaman:birimler = "1992-1-1'den bu yana saniye 00:00:00";
Z:units = "jeopotansiyel metre";
Z:geçerli_aralık = 0., 5000.;
p:_FillValue = -9999.;
rh:_FillValue = -1;

veri:
enlem = 0, 10, 20, 30, 40, 50, 60, 70, 80, 90;
boy = -140, -118, -96, -84, -52;
}

Tüm CDL ifadeleri noktalı virgül ile sonlandırılır. Boşluklar, sekmeler ve yeni satırlar kullanılabilir
okunabilirlik için özgürce. Yorumlar herhangi bir satırda `//' karakterlerini takip edebilir.

Bir CDL açıklaması üç isteğe bağlı bölümden oluşur: boyutlar, değişkenler, ve veri,
anahtar kelime ile başlayan boyutlar:, değişkenleri:, ve veri, sırasıyla. Değişken
kısım içerebilir değişken bildirimleri ve nitelik ödevler.

bir netCDF boyut çok boyutlu nesnelerin bir veya daha fazlasının şeklini tanımlamak için kullanılır.
netCDF dosyasında bulunan değişkenler. Bir netCDF boyutunun bir adı ve boyutu vardır. NS
bir netCDF dosyasındaki çoğu boyut, sınırsız boyut, yani bir değişken
bu boyutun kullanılması herhangi bir uzunluğa ulaşabilir (bir dosyadaki kayıt numarası gibi).

A değişken aynı türden çok boyutlu bir değerler dizisini temsil eder. Bir değişken var
bir ad, bir veri türü ve boyut listesiyle tanımlanan bir şekil. Her değişken
ayrıca ilişkilendirdi öznitelikleri (aşağıya bakın) ve veri değerleri. Ad, veri türü,
ve bir değişkenin şekli, içindeki bildirimi ile belirtilir. değişken bir CDL'nin bölümü
tanım. Bir değişken, boyutla aynı ada sahip olabilir; sözleşmeyle böyle bir
değişken tek boyutludur ve adlandırdığı boyutun koordinatlarını içerir.
Boyutların karşılık gelen değişkenlere sahip olması gerekmez.

bir netCDF nitelik bir netCDF değişkeni veya tüm netCDF hakkında bilgi içerir
veri kümesi. Nitelikler, birimler, özel değerler, maksimum gibi özellikleri belirtmek için kullanılır.
ve minimum geçerli değerler, ölçekleme faktörleri, ofsetler ve parametreler. Özellik bilgisi
tek değerler veya değer dizileri ile temsil edilir. Örneğin, "birimler" bir niteliktir
"santigrat" gibi bir karakter dizisi ile temsil edilir. Bir özniteliğin ilişkili bir
değişken, ad, veri türü, uzunluk ve değer. Değişkenlerin aksine
verilere yöneliktir, nitelikler meta verilere yöneliktir (veriler hakkındaki veriler).

CDL'de, bir öznitelik, bir değişken ve öznitelik adıyla belirlenir ve ":" ile ayrılır. Bilişim Teknoloji
atamak mümkün global netCDF'ye herhangi bir değişkenle ilişkili olmayan nitelikler
öznitelik adından önce `:' kullanılarak bir bütün. CDL'deki bir özniteliğin veri türü
kendisine atanan değerin türünden türetilir. Bir özelliğin uzunluğu,
kendisine atanan veri değerlerinin sayısı veya karakter dizisindeki karakter sayısı
ona atanır. Karakter olmayan özniteliklere ayırarak birden çok değer atanır.
virgül ile değerler. Bir özniteliğe atanan tüm değerler aynı türde olmalıdır.

CDL boyutları, değişkenleri ve niteliklerinin adları alfabetik bir harfle başlamalıdır.
karakter veya "_" ve sonraki karakterler alfasayısal veya "_" veya "-" olabilir.

İsteğe bağlı veri bir CDL spesifikasyonunun bölümü, netCDF değişkenlerinin olabileceği yerdir.
başlatıldı. Bir başlatmanın sözdizimi basittir: bir değişken adı, bir eşittir işareti,
ve virgülle ayrılmış sabitler listesi (muhtemelen boşluklar, sekmeler ve yeni satırlarla ayrılmış)
noktalı virgül ile sonlandırılır. Çok boyutlu diziler için son boyut değişir
en hızlı. Bu nedenle matrisler için sütun sırası yerine satır sırası kullanılır. Daha az değer varsa
bir değişkeni doldurmak için gerekenden sağlanırsa, türe bağlı olarak genişletilir.
Ayırt edici bir değişken için bir değer sağlayarak geçersiz kılınabilen 'dolgu değeri'
'_FillValue' adlı öznitelik. Sabit türlerinin, belirtilen türle eşleşmesi gerekmez.
bir değişken; örneğin tam sayıları kayan noktaya dönüştürmek için zorlamalar yapılır.

Ilkel Veri Türleri
tank karakterler
bayt 8-bit veri
kısa 16 bit işaretli tam sayılar
ve kazandırdı 32 bit işaretli tam sayılar
int (ile eşanlamlı ve kazandırdı)
şamandıra IEEE tek duyarlıklı kayan nokta (32 bit)
gerçek (ile eşanlamlı şamandıra)
çift IEEE çift duyarlıklı kayan nokta (64 bit)

Eklenen veri türü hariç bayt ve eksikliği imzasız, CDL aynı şeyi destekler
C gibi ilkel veri türleri. İlkel veri türlerinin adları,
CDL, bu nedenle değişkenlerin, boyutların ve niteliklerin adları tür adları olmamalıdır. İçinde
bildirimlerde, tür adları büyük veya küçük harfle belirtilebilir.

Baytlar, sekiz bitlik veriyi tam olarak tutmayı amaçladıkları için karakterlerden farklıdır.
ve sıfır baytın, karakter verileri için olduğu gibi özel bir önemi yoktur. ncgen
dönüştürür bayt deklarasyonlar tank çıktı C kodundaki ve
Standart dışı BYTE çıktı Fortran kodunda bildirim.

Şortlar -32768 ile 32767 arasında değerler alabilir. ncgen dönüştürür kısa deklarasyonlar
kısa çıktı C kodundaki ve standart dışı bildirimler TAM SAYI*2 beyanname
çıktı Fortran kodu.

Uzunlar -2147483648 ile 2147483647 arasındaki değerleri tutabilir. ncgen dönüştürür ve kazandırdı
deklarasyonlar ve kazandırdı çıktı C kodundaki bildirimler ve INTEGER beyannameler
çıktı Fortran kodu. int ve tamsayı eş anlamlı olarak kabul edilir ve kazandırdı CDL'de
beyanlar. Artık C uzunlukları için 64-bit temsilleri olan platformlar olduğuna göre,
kullanmak daha iyi olabilir int karışıklığı önlemek için eş anlamlısı.

Şamandıralar yaklaşık -3.4+38 ile 3.4+38 arasında değerler tutabilir. Onların dış temsili
32-bit IEEE normalleştirilmiş tek duyarlıklı kayan nokta sayıları olarak. ncgen dönüştürür şamandıra
deklarasyonlar şamandıra çıktı C kodundaki bildirimler ve GERÇEK çıktıdaki bildirimler
Fortran kodu. gerçek eş anlamlısı olarak kabul edilir şamandıra CDL beyannamelerinde.

Çiftler yaklaşık -1.7+308 ile 1.7+308 arasında değerler tutabilir. Onların dış temsili
64-bit IEEE standart normalleştirilmiş çift duyarlıklı kayan nokta sayıları gibidir. ncgen
dönüştürür çift deklarasyonlar çift çıktı C kodundaki bildirimler ve ÇİFT
HASSAS Çıktı Fortran kodundaki bildirimler.

CDL Sabitler
Niteliklere veya değişkenlere atanan sabitler, temel netCDF türlerinden herhangi biri olabilir.
Sabitlerin sözdizimi, tür soneklerinin
onları uzun ve çiftlerden ayırt etmek için şortlara ve şamandıralara eklenir.

A bayt sabit, tek bir karakter veya çok karakterli kaçış dizisi ile temsil edilir
tek tırnak içine alınır. Örneğin,
'a' // ASCII 'a'
'\0' // sıfır bayt
'\n' // ASCII yeni satır karakteri
'\33' // ASCII kaçış karakteri (33 sekizlik)
'\x2b' // ASCII artı (2b hex)
'\377' // 377 sekizlik = 255 ondalık, ASCII olmayan

Karakter sabitleri çift tırnak içine alınır. Bir karakter dizisi temsil edilebilir
çift ​​tırnak içine alınmış bir dize olarak. Her zamanki C dizisi kaçış kuralları yerine getirilir.
Örneğin
"a" // ASCII `a'
"İki\nsatır\n" // iki gömülü yeni satır içeren 10 karakterlik bir dize
"a bell:\007" // bir ASCII zili içeren bir dize
"a" netCDF karakter dizisinin tek elemanlı bir değişkene sığacağını unutmayın, çünkü hiçbir
NULL karakterinin sonlandırıldığı varsayılır. Ancak, bir karakter dizisindeki sıfır bayt
tarafından önemli karakterlerin sonu olarak yorumlanır. ncdump programı takip ederek,
C kongresi. Bu nedenle, bir NULL bayt, bir karakter dizgisine gömülmemelidir.
sonunda: kullanın bayt sıfır bayt içeren bayt dizileri için veri türü.
NetCDF ve CDL'nin dize türü yoktur, yalnızca sabit uzunluklu karakter dizileri vardır.
çok boyutlu.

kısa tamsayı sabitleri, 16 bitlik işaretli miktarları temsil etmek için tasarlanmıştır. form
bir bölgesinin kısa sabit, sonuna "s" veya "S" eklenmiş bir tam sayı sabitidir. Eğer bir kısa
sabit "0" ile başlar, sekizli olarak yorumlanır, ancak "0x" ile başlıyorsa,
onaltılık bir sabit olarak yorumlanır. Örneğin:
-2s // kısa bir -2
0123s // sekizli
0x7ffs // onaltılık

Uzun tamsayı sabitleri, 32 bitlik işaretli miktarları temsil etmek için tasarlanmıştır. form
bir bölgesinin ve kazandırdı sabit, sıradan bir tamsayı sabitidir, ancak
isteğe bağlı 'l' veya 'L'. Eğer bir ve kazandırdı sabit '0' ile başlar, sekizli olarak yorumlanır,
'0x' ile başlıyorsa, onaltılık bir sabit olarak yorumlanması dışında. Örnekler
geçerli ve kazandırdı sabitler şunları içerir:
-2
1234567890L
0123 // sekizli
0x7ff // onaltılık

Türün kayan nokta sabitleri şamandıra kayan noktayı temsil etmek için uygundur
yaklaşık yedi önemli basamaklı kesinlik içeren veriler. formu bir şamandıra sabit
"f" veya "F" eklenmiş bir C kayan nokta sabiti ile aynı. örneğin
Aşağıdakilerin tümü kabul edilebilir şamandıra sabitler:
-2.0f
3.14159265358979f // daha az hassasiyetle kesilecek
1.f.

Türün kayan nokta sabitleri çift kayan noktayı temsil etmek için uygundur
yaklaşık on altı önemli basamaklı kesinlik içeren veriler. formu bir çift sabit
C kayan nokta sabiti ile aynı. İsteğe bağlı bir "d" veya "D" eklenebilir. İçin
örnek, aşağıdakilerin tümü kabul edilebilir çift sabitler:
-2.0
3.141592653589793
1.0e-20
1. d

onworks.net hizmetlerini kullanarak ncgen-hdf'yi çevrimiçi kullanın