Un fichier NetCDF possède des dimensions, des variables et des attributs. Voici un petit exemple de fichier NetCDF, pour illustrer ces concepts de dimensions, variables et attributs. La notation utilisée pour décrire ce fichier NetCDF est appelée CDL (network Common Data Language). Elle donne une version ``texte'' qui permet une compréhension facile de la struture et du contenu d'un fichier NetCDF binaire :
netcdf exp3rass915.930110.0102 {
dimensions:
time = UNLIMITED ; // (1 currently)
x = 25 ;
variables:
long base_time ;
double time_offset(time) ;
float height(time, x) ;
height:missing_value = 9999.f ;
float tv(time, x) ;
tv:missing_value = 9999.f ;
float lat ;
float lon ;
float alt ;
float x_spacing ;
data:
base_time = 726627756
time_offset = 0
height =
90 , 150 , 210 , 270 , 330 , 390 , 450 , 510 , 570 , 630 , 690 , 750 ,
810 , 870 , 930 , 990 , 1050 , 1110 , 1170 , 1230 , 1290 , 1350 , 1410 ,
1470 , 1530 ;
tv =
31.1 , 30.4 , 29.9 , 29.5 , 29.1 , 28.6 , 28.1 , 27.3 , 26.7 , 26.2 ,
25.8 , 25.4 , 24.9 , 24.5 , 24.3 , 24.2 , 24 , 9999 , 9999 , 9999 ,
9999 , 9999 , 9999 , 9999 , 9999 ;
lat = 40 ;
lon = 285 ;
alt = 94 ;
x_spacing = 60 ;
}
Le fichier notation CDL peut être généré automatiquement à partir d'un fichier NetCDF, grace à l'utilitaire ncdump. Un autre utilitaire, ncgen, génère un fichier NetCDF (ou un source C ou Fortran contenant les appels nécessaires pour produire un fichier NetCDF) à partir d'une entrée CDL.
Il n'est pas utile d'en savoir plus sur la notation CDL pour utiliser la bibliothèque NetCDF. Elle est seulement utilisée pour présenter des exemples de fichiers NetCDF.
En règle générale, les commande CDL se terminent par un ``;''. Les espaces, tabulations et sauts de lignes peuvent être utilisés librement pour améliorer la lisibilité. Les commentaires en CDL suivent les caractères ``//''. La description CDL d'un fichier NetCDF prend la forme suivante :
NetCDF name {
dimensions: ...
variables: ...
data: ...
}
où ``name'' est seulement utilisé comme le nom par défaut lors de la constitution du fichier NetCDF par l'utilitaire ncgen . La description CDL comporte 3 parties, introduites par les mots clés dimensions , variables et data . Les déclarations des dimensions NetCDF apparaissent après le mot-clé dimensions, les variables NetCDF après le mot-clé variables , et l'affectation des données après le mot-clé data .