ncdump - En ligne dans le Cloud

PROGRAMME:

Nom

ncdump - Convertit le fichier netCDF en forme de texte (CDL)

SYNOPSIS

ncdump [-chistxw] [-v variable1,...] [-b long] [-F long] [-l len] [-n prénom] [-p
f_chiffres[,d_chiffres]] [-g groupe1,...] filet

ncdump-k filet

DESCRIPTION

La cdump l'utilitaire génère une représentation textuelle d'un fichier netCDF spécifié en standard
sortie, en excluant éventuellement certaines ou toutes les données variables dans la sortie. Le texte
représentation est sous une forme appelée CDL (Network Common Data Form Language) qui peut être
consultés, modifiés ou servir d'entrée à ngen, un programme compagnon qui peut générer un binaire
netCDF à partir d'un fichier CDL. D'où ngen et cdump peut être utilisé comme inverse pour transformer
la représentation des données entre les représentations binaires et textuelles. Voir ngen Documentation
pour une description des représentations CDL et netCDF.

cdump peut également être utilisé pour déterminer quel type de fichier netCDF est utilisé (quelle variante de
le format de fichier netCDF) avec l'option -k.

Si la prise en charge DAP était activée lorsque cdump a été construit, le nom du fichier peut spécifier une URL DAP.
Ceci permet cdump pour accéder aux sources de données des serveurs DAP, y compris les données dans d'autres
formats que netCDF. Lorsqu'il est utilisé avec des URL DAP, cdump montre la traduction du DAP
modèle de données au modèle de données netCDF.

cdump peut également être utilisé comme un simple navigateur pour les fichiers de données netCDF, pour afficher les
noms et longueurs des dimensions ; noms, types et formes de variables ; noms d'attributs et
valeurs; et facultativement, les valeurs des données pour toutes les variables ou variables sélectionnées dans un
fichier netCDF. Pour les fichiers netCDF-4, les groupes et les types définis par l'utilisateur sont également inclus dans
sortie ncdump.

cdump utilise `_' pour représenter les valeurs de données qui sont égales à l'attribut `_FillValue' pour
une variable, destinée à représenter des données qui n'ont pas encore été écrites. Si une variable a
pas d'attribut `_FillValue', la valeur de remplissage par défaut pour le type de variable est utilisée sauf si le
la variable est de type octet.

cdump définit un format d'affichage par défaut utilisé pour chaque type de données netCDF, mais cela peut être
changé si un attribut `C_format' est défini pour une variable netCDF. Dans ce cas, cdump
utilisera l'attribut `C_format' pour formater chaque valeur. Par exemple, si la virgule flottante
les données de la variable netCDF « Z » sont connues pour être précises à seulement trois chiffres significatifs,
il serait approprié d'utiliser l'attribut variable

Z:C_format = "%.3g"

OPTIONS

-c Afficher les valeurs de coordonner variables (variables 1D avec les mêmes noms que
dimensions) ainsi que les déclarations de toutes les dimensions, variables, attributs
valeurs, groupes et types définis par l'utilisateur. Valeurs de données des variables non coordonnées
ne sont pas inclus dans la sortie. C'est généralement l'option la plus appropriée à utiliser
pour un bref aperçu de la structure et du contenu d'un fichier netCDF.

-h Afficher uniquement le entête informations dans la sortie, c'est-à-dire, ne sortir que le
déclarations pour les dimensions, variables, attributs, groupes et définis par l'utilisateur
types du fichier d'entrée, mais aucune valeur de données pour aucune variable. La sortie est
identique à l'utilisation du -c sauf que les valeurs des variables de coordonnées sont
non inclus. (Au plus un des -c or -h des options peuvent être présentes.)

-v variable1,...
La sortie inclura des valeurs de données pour les variables spécifiées, en plus des
déclarations de toutes les dimensions, variables et attributs. Une ou plusieurs variables
doit être spécifié par son nom dans la liste délimitée par des virgules suivant cette option. Les
list doit être un seul argument de la commande, donc ne peut pas contenir d'échappement
des blancs ou d'autres caractères d'espace blanc. Les variables nommées doivent être netCDF valides
variables dans le fichier d'entrée. Une variable au sein d'un groupe dans un fichier netCDF-4 peut être
spécifié avec un nom de chemin absolu, tel que `/GroupA/GroupA2/var'. Utilisation d'un
le nom de chemin relatif tel que `var' ou `grp/var' spécifie tous les noms de variables correspondants
dans le fichier. La valeur par défaut, sans cette option et en l'absence du -c or -h
options, consiste à inclure des valeurs de données pour tous variables dans la sortie.

-b [c|f]
Une brève annotation sous forme de commentaire CDL (texte commençant par les caractères
``//'') sera inclus dans la section de données de la sortie pour chaque `ligne' de données,
pour aider à identifier les valeurs des données pour les variables multidimensionnelles. Si long commence par
`C' ou `c', alors les conventions du langage C seront utilisées (indices de base zéro, dernier
dimension variant le plus rapidement). Si long commence par 'F' ou 'f', puis le langage Fortran
des conventions seront utilisées (indices à base unique, première dimension variant le plus rapidement). Dans
dans les deux cas, les données seront présentées dans le même ordre ; seulement les annotations
différera. Cette option peut être utile pour parcourir de gros volumes de
données multidimensionnelles.

-f [c|f]
Annotations complètes sous forme de commentaires CDL de fin (texte commençant par le
caractères ``//'') pour chaque valeur de données (à l'exception des caractères individuels dans le caractère
tableaux) seront inclus dans la section de données. Si long commence par « C » ou « c », puis
Les conventions du langage C seront utilisées. Si long commence par 'F' ou 'f', puis Fortran
les conventions linguistiques seront utilisées. Dans les deux cas, les données seront présentées dans
la même commande ; seules les annotations seront différentes. Cette option peut être utile pour
canaliser les données dans d'autres filtres, puisque chaque valeur de données apparaît sur une ligne distincte,
pleinement identifié. (Au plus une des options '-b' ou '-f' peut être présente.)

-l longueur
Modifie la longueur de ligne maximale par défaut (80) utilisée dans le formatage des listes de non-
valeurs de données de caractère.

-n prénom
CDL requiert un nom pour un fichier netCDF, à utiliser par ngen -b en générant une valeur par défaut
nom de fichier netCDF. Par défaut, cdump construit ce nom à partir du dernier composant
du nom de fichier du fichier netCDF d'entrée en supprimant toute extension dont il dispose.
Utilisez l'option -n option pour spécifier un nom différent. Bien que le nom du fichier de sortie utilisé
by ngen -b peut être spécifié, il peut être judicieux d'avoir cdump changer le nom par défaut
pour éviter d'écraser par inadvertance un fichier netCDF précieux lors de l'utilisation cdump,
éditer le fichier CDL résultant et utiliser ngen -b pour générer un nouveau fichier netCDF
à partir du fichier CDL édité.

-p float_digits[,double_digits]
Spécifie la précision par défaut (nombre de chiffres significatifs) à utiliser pour l'affichage
valeurs de données à virgule flottante ou double précision pour les attributs et les variables. Si
spécifié, cette valeur remplace la valeur de l'attribut C_format, le cas échéant, pour un
variable. Les données à virgule flottante seront affichées avec chiffres_flottants significative
chiffres. Si double_chiffres est également spécifié, les valeurs en double précision seront
affiché avec autant de chiffres significatifs. En l'absence de tout -p
les spécifications, les données à virgule flottante et en double précision sont affichées avec 7 et
15 chiffres significatifs respectivement. Les fichiers CDL peuvent être réduits si moins
la précision est requise. Si à la fois la virgule flottante et la double précision sont spécifiées,
les deux valeurs doivent apparaître séparées par une virgule (pas d'espaces) en tant qu'argument unique pour
la commande. (Pour représenter chaque dernier bit de précision dans un fichier CDL pour tous
d'éventuelles valeurs à virgule flottante nécessiteraient -p 9,17.)

-k Afficher le type de fichier netCDF les références de chemin d'accès, l'un des « classique », « 64 bits
offset', 'netCDF-4', ou 'netCDF-4 classic model'. Avant la version 3.6, il y avait
un seul type de fichier netCDF, désigné comme « classique » (également connu sous le nom de variante de format
1). La prise en charge des fichiers volumineux a introduit une autre variante du format, désignée comme
« Décalage 64 bits » (connu sous le nom de variante de format 2). NetCDF-4, utilise une troisième variante du
format, `netCDF-4' (variante de format 3). Une autre variante de format, désignée
« modèle classique netCDF-4 » (variante de format 4), est limité aux fonctionnalités prises en charge par
le modèle de données netCDF-3 mais représenté au format HDF5, de sorte qu'un
le programme netCDF-3 non modifié peut lire ou écrire le fichier simplement en se reconnectant avec le
bibliothèque netCDF-4. La chaîne sortie en utilisant l'option `-k' peut être fournie comme
la valeur de l'option `-k' pour ngen(1) pour spécifier exactement quel type de netCDF
à générer, lorsque vous souhaitez remplacer la valeur par défaut déduite du CDL.

-s Sortir des attributs virtuels spéciaux qui fournissent des informations relatives aux performances
sur le format de fichier et les propriétés des variables pour les données netCDF-4. Ces spéciaux
les attributs virtuels ne font pas réellement partie des données, ils sont simplement un outil pratique
moyen d'afficher diverses propriétés des données dans CDL (et éventuellement NcML).
Ils incluent `_ChunkSizes', `_DeflateLevel', `_Endianness', `_Fletcher32',
`_Format', `_NoFill', `_Shuffle' et `_Storage'. `_ChunkSizes' est une liste de morceaux
tailles pour chaque dimension de la variable. `_DeflateLevel' est un entier compris entre 0
et 9 inclus si la compression a été spécifiée pour la variable. `_Endianité'
est soit « petite » ou « grande », selon la façon dont la variable a été stockée lors de la première
écrit. `_Fletcher32' est `true' si la propriété de somme de contrôle a été définie pour le
variable. `_Format' est un attribut global spécifiant la variante de format netCDF,
l'un des `classic', `64-bit offset', `netCDF-4', ou `netCDF-4 classic model'.
`_NoFill' est `true' si la propriété NoFill persistante a été définie pour la variable lorsque
il a été défini. `_Shuffle' est `true' si l'utilisation du filtre aléatoire a été spécifiée
pour la variable. `_Storage' est `contiguë' ou `chunked', selon la façon dont le
les données de la variable sont stockées.

-t Contrôle l'affichage des données de temps, si elles sont stockées dans une variable qui utilise un udunits
représentation de l'heure conforme telle que « jours depuis 1970-01-01 » ou « secondes depuis
2009-03-15 12:01:17', une variable identifiée dans un attribut "bornes" d'un tel temps
variable, ou un attribut numérique d'une variable de temps. Si cette option est spécifiée,
les valeurs de données temporelles sont affichées sous forme de chaînes date-heure lisibles par l'homme plutôt que
valeurs numériques, interprétées en termes d'attribut de variable "calendrier", si
spécifié. Pour les attributs numériques des variables de temps, la valeur de temps lisible par l'homme
s'affiche après la valeur réelle, dans un commentaire CDL associé. Calendrier
les valeurs d'attribut interprétées avec cette option incluent les valeurs des conventions CF
`gregorian' ou `standard', `proleptique_gregorian', `noleap' ou `365_day', `all_leap'
ou "366_day", "360_day" et "julian".

-i Identique à l'option '-t', à l'exception des données d'heure de sortie sous forme de chaînes date-heure avec ISO-8601
séparateur standard « T », au lieu d'un blanc.

-g groupe1,...
Pour les fichiers netCDF-4, la sortie inclura des valeurs de données uniquement pour le
groupes. Un ou plusieurs groupes doivent être spécifiés par leur nom dans la liste délimitée par des virgules
suivant cette option. La liste doit être un seul argument de la commande. Le nommé
Les groupes doivent être des groupes netCDF valides dans le fichier d'entrée. Un groupe dans un fichier netCDF-4
peut être spécifié avec un nom de chemin absolu ou relatif. Utilisation d'un chemin relatif
name spécifie tous les noms de groupe correspondants dans le fichier. La valeur par défaut, sans cela
option et en l'absence de -c or -h options, consiste à inclure des valeurs de données pour
tous groupes dans la sortie.

-w Pour les noms de fichiers qui demandent un accès à distance à l'aide d'URL DAP, accédez aux données avec client-
mise en cache latérale de variables entières.

-x Sortie XML (NcML) au lieu de CDL. Le NcML n'inclut pas les valeurs de données. Le NcML
L'option de sortie ne fonctionne actuellement que pour les données de modèle classique netCDF.

EXEMPLES

Regardez la structure des données dans le fichier netCDF `foo.nc':

ncdump -c foo.nc

Produire une version CDL annotée de la structure et des données dans le fichier netCDF `foo.nc',
en utilisant l'indexation de style C pour les annotations :

ncdump -bc foo.nc > foo.cdl

Données de sortie uniquement pour les variables `uwind' et `vwind' du fichier netCDF `foo.nc', et
afficher les données à virgule flottante avec seulement trois chiffres significatifs de précision :

ncdump -v uwind,vwind -p 3 foo.nc

Produire une liste entièrement annotée (une valeur de données par ligne) des données de la variable
« omega », en utilisant les conventions Fortran pour les indices et en modifiant le nom du jeu de données netCDF dans
le fichier CDL résultant dans `omega' :

ncdump -v omega -f fortran -n omega foo.nc > Z.cdl

Utiliser ncdump en ligne à l'aide des services onworks.net