Décrire un fichier NetCDF (Multidimension)

Synthèse

Décrit la nature et le contenu d’un jeu de données netCDF en entrée. Répertoriez toutes les variables avec leurs dimensions et leurs attributs.

Utilisation

• Cet outil prend en charge les formats netCDF-3 et netCDF-4 avec les extensions .nc et .nc4.

• Cet outil génère un message de géotraitement et un fichier texte Markdown en option en sortie.

  Les messages de géotraitement de l’outil décrivent les caractéristiques et le contenu du fichier netCDF en entrée. Les messages comprennent les informations suivantes sur le fichier netCDF :

  • Le chemin d’accès au fichier netCDF en entrée.
  • La table Dimensions décrit la forme des variables. Elle est composée de trois colonnes : Dimension, Taille et Variables. Les lignes spécifient le nom de la dimension, la taille de la dimension et les variables associées à la dimension.
  • La table Variables décrit les variables. Elle est composée de quatre colonnes : Variable, Type de données, Dimensions et Attributs. Chaque variable est associée à une ou plusieurs dimensions et peut stocker différents types de données (entier, réel ou caractère). Les attributs fournissent un contexte et des détails sur les données stockées dans chaque variable, comme les unités de mesure, des descriptions et les valeurs manquantes.
  • La table Attributs globaux décrit les métadonnées. Elle est composée de deux colonnes : Nom de l’attribut et Valeur attributaire. Elle peut être utilisée pour stocker des informations générales telles que l’origine, la convention et l’historique du jeu de données, ainsi que d’autres détails.

• Si une valeur est fournie pour le paramètre Fichier de description en sortie (out_file dans Python), l’outil crée une table qui comporte le contenu du message de géotraitement. Le fichier de description en sortie peut être enregistré aux formats .txt, .cdl et .md. Si aucune extension de fichier n’est fournie, le fichier en sortie est enregistré au format .txt.

• Cet outil ne lit pas les fichiers netCDF générés par la boîte à outils Exploration des modèles spatio-temporels. Utilisez l’outil Décrire un cube spatio-temporel qui fournit des fonctions avancées, pour décrire le contenu de ce type de fichier.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Fichier NetCDF en entrée	Fichier NetCDF en entrée qui sera décrit.	File
Fichier de description en sortie (Facultatif)	Nom du fichier texte Markdown de description de la sortie qui contiendra les informations récapitulatives sur le fichier netCDF en entrée. Spécifiez le nom de fichier avec une extension .md, .cdl ou .txt.	File

Python

arcpy.md.DescribeNetCDFFile(in_netCDF_file, {out_file})

Nom	Explication	Type de données
in_netCDF_file	Fichier NetCDF en entrée qui sera décrit.	File
out_file (Facultatif)	Nom du fichier texte Markdown de description de la sortie qui contiendra les informations récapitulatives sur le fichier netCDF en entrée. Spécifiez le nom de fichier avec une extension .md, .cdl ou .txt.	File

Exemple de code

Exemple 1 d’utilisation de la fonction DescribeNetCDFFile (fenêtre Python)

Décrit un fichier netCDF.

import arcpy    
arcpy.md.DescribeNetCDFFile(in_netCDF_file=r"C:\example\airtemp.nc")

Exemple 2 d’utilisation de la fonction DescribeNetCDFFile (script autonome)

Décrit un fichier netCDF.

# Name: DescribeNetCDFFile.py  
# Description: Describe a NetCDF dataset.  

# Import system modules 
import arcpy 
 
# Set environment settings  
arcpy.env.workspace = "C:/data" 

# Set a variable 
in_netCDF_file = r"C:\example\airtemp.nc" 
out_file = r"C:\example\summary.md" 

# Run DescribeNetCDFFile 
arcpy.md.DescribeNetCDFFile(in_netCDF_file, out_file)

Environnements

Espace de travail courant, Espace de travail temporaire

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui