Points NetCDF vers classe d’entités (géométrie d’échantillonnage discret) (Outils multidimensionnels)

Synthèse

Crée une classe d’entités à partir de points dans des fichiers netCDF. Dans la convention des métadonnées des données de climat et de prévision, un point est un type de géométrie d’échantillonnage discret.

En savoir plus sur le fonctionnement des outils Géométrie d’échantillonnage discret

Utilisation

• Dans la convention des métadonnées de climat et de prévision, un point est un point de données unique qui n’a aucune relation de coordonnées implicite avec d’autres points.

• Les jeux de données de géométrie d’échantillonnage discret se caractérisent par une dimensionnalité inférieure par rapport à la région spatio-temporelle où les données sont échantillonnées.

• Les fichiers netCDF en entrée doivent être conformes à la convention des métadonnées des données de climat et de prévision (CF 1.6 ou version ultérieure). Les conventions des métadonnées des données de climat et de prévision définissent les métadonnées qui décrivent les données représentées par chaque variable, ainsi que les propriétés spatiales et temporelles des données.

• Si les fichiers netCDF en entrée ne sont pas conformes à la convention sur le climat et la prévision, vous pouvez spécifier un fichier Input Climate and Forecast Metadata (Métadonnées des données de climat et de prévision en entrée) (in_cf_metadata dans Python) avec des attributs supplémentaires ou modifiés. Le fichier Input Climate and Forecast Metadata (Métadonnées des données de climat et de prévision en entrée) est un fichier XML avec une extension .ncml. Les attributs de ce fichier de métadonnées prolongeront ou remplaceront les métadonnées du fichier netCDF. Le fichier Métadonnées des données de climat et de prévision en entrée permet également de spécifier une variable d’appariement de grille si le fichier netCDF en entrée n’en possède pas.

• Plusieurs variables d’instance peuvent être sélectionnées pour le paramètre Instance Variables (Variables d’instance) (instance_variables dans Python).

• Si les fichiers netCDF en entrée contiennent des variables organisées en groupes, le paramètre Instance Variables (Variables d’instance) répertorie les variables avec leur chemin absolu, préfixé d’une barre oblique ("/"), indiquant leur emplacement par rapport au groupe racine. Par exemple, la variable precip située dans le groupe /g1 est affichée sous la forme /g1/precip.

• Il est possible de convertir plusieurs fichiers de points DSG netCDF, spécifiés comme fichiers ou dossiers individuels, en une même classe d’entités avec un champ instanceID unique. Pour les variables d’instance, l’appariement est effectué par nom de variable. En d’autres termes, si deux variables dans différents fichiers netCDF portent le même nom, elles sont interprétées comme désignant la même chose. Si les variables sont présentes dans des groupes, les noms de variable sont pris en compte avec leur chemin absolu lors de l’appariement. Si plusieurs variables de même nom sont présentes dans des emplacements différents par rapport au groupe racine (par exemple, /g1/precip et /g2/precip), elles sont interprétées comme désignant des choses différentes.

• Vous pouvez utiliser le paramètre Étendue d’analyse (analysis_extent dans Python) afin de spécifier la zone d’analyse en sortie explicitement pour l’exécution d’un outil autonome ou de remplacer le paramètre d’environnement dans le cadre d’un processus. Vous pouvez spécifier l’étendue en saisissant des valeurs, en choisissant l’étendue d’affichage, en sélectionnant une couche ou en recherchant un jeu de données en entrée.

• La valeur Étendue d’analyse par défaut est calculée à partir de l’étendu d’union des fichiers netCDF en entrée.

• Si l’étendue n’est pas explicitement spécifiée comme valeur de paramètre, elle est dérivée des paramètres d’environnement d’analyse.

• Une classe d’entités ponctuelles 2D ou 3D contenant toutes les informations de localisation ainsi que les valeurs des données pour la valeur de paramètre Instance Variables (Variables d’instance) sélectionnée est créée.

• Une variable de données dans le fichier netCDF peut utiliser une variable grid_mapping pour définir explicitement le système de coordonnées de référence utilisé pour les valeurs de coordonnées spatiales. Vous pouvez utiliser l’attribut epsg_code d’appariement de grille pour sélectionner un système de coordonnées géographiques ou projetées. De plus, les attributs esri_pe_string, crs_wkt et spatial_ref d’appariement de grille peuvent tous être utilisés pour définir une chaîne WKT 1 ou WKT 2. Si certains de ces attributs sont présents, aucun autre attribut pour le système de coordonnées horizontales n’est utilisé. Pour plus d'informations sur les systèmes de référence de coordonnées, ainsi que sur les WKID pris en charge, reportez-vous à la rubrique Systèmes de coordonnées, projections et transformations.

• Si les valeurs de coordonnées spatiales sont de type 3D, la variable grid_mapping doit également spécifier un système de coordonnées verticales. Un système de coordonnées verticales est une combinaison d’un datum vertical, d’une unité linéaire de mesure et de la direction (haut ou bas) dans laquelle les coordonnées verticales augmentent. Le datum s’obtient généralement à partir d’un attribut de la variable d’appariement de grille et des autres propriétés à partir de la variable de coordonnées verticales. Un datum vertical arbitraire peut être spécifié en utilisant une chaîne WKT composée comme valeur de l’un des attributs WKT répertoriés ci-dessus. Un datum basé sur la gravité peut être spécifié en utilisant l’attribut geoid_name ou geopotential_datum_name. En outre, un datum de marée peut être implicitement spécifié en utilisant l’un des noms standard de marée pour la variable de coordonnées verticales. Si aucun système de coordonnées verticales n’est spécifié et qu’une variable de coordonnées verticales est présente, WGS 1984 Ellipsoid Height (wkid115700) est sélectionné par défaut.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Fichiers ou dossiers NetCDF en entrée	Fichiers netCDF en entrée à utiliser pour créer une classe d’entités. Des fichiers netCDF individuels, ainsi que les dossiers qui contiennent plusieurs fichiers netCDF, peuvent être utilisés. Les fichiers netCDF en entrée doivent comporter le même type d’entité DSG et la même structure.	Folder; File
Espace de travail cible	Géodatabase (d’entreprise ou fichier) ou dossier dans lequel la table et la classe d’entités en sortie sont créées. Il doit s’agir d’un espace de travail existant.	Workspace
Nom de point en sortie	Nom de la classe d’entités qui contient les localisations des variables netCDF. Ces variables sont ajoutées sous forme de champs à partir du paramètre Variables d’instance.	String
Variables d’instance (Facultatif)	Variables netCDF qui distinguent les entités individuelles et représentent les localisations où des observations sont réalisées. Ces variables sont ajoutées sous forme de champs à la classe d’entités en sortie.	String
Inclure les sous-répertoires (Facultatif)	Spécifie si les fichiers résidant dans les sous-répertoires d’un dossier en entrée sont utilisés. Activé : tous les fichiers netCDF dans tous les sous-répertoires sont utilisés. Désactivé : seuls les fichiers dans le dossier en entrée sont utilisés. Il s’agit de l’option par défaut.	Boolean
Métadonnées des données de climat et de prévision en entrée (Facultatif)	Fichier au format XML avec une extension .ncml qui fournit les informations CF manquantes ou modifiées pour les fichiers netCDF en entrée.	File
Étendue d’analyse (Facultatif)	Étendue qui définit la zone de la classe d’entités en sortie.	Extent

Sortie obtenue

Étiquette	Explication	Type de données
Point en sortie	Classe d’entités ponctuelles en sortie.	Feature Class

Python

arcpy.management.NetCDFPointsToFeatureClass(in_files_or_folders, target_workspace, out_point_name, {instance_variables}, {include_subdirectories}, {in_cf_metadata}, {analysis_extent})

Nom	Explication	Type de données
in_files_or_folders [in_files_or_folders,...]	Fichiers netCDF en entrée à utiliser pour créer une classe d’entités. Des fichiers netCDF individuels, ainsi que les dossiers qui contiennent plusieurs fichiers netCDF, peuvent être utilisés. Les fichiers netCDF en entrée doivent comporter le même type d’entité DSG et la même structure.	Folder; File
target_workspace	Géodatabase (d’entreprise ou fichier) ou dossier dans lequel la table et la classe d’entités en sortie sont créées. Il doit s’agir d’un espace de travail existant.	Workspace
out_point_name	Nom de la classe d’entités qui contient les localisations des variables netCDF. Ces variables sont ajoutées sous forme de champs à partir du paramètre instance_variables.	String
instance_variables [instance_variables,...] (Facultatif)	Variables netCDF qui distinguent les entités individuelles et représentent les localisations où des observations sont réalisées. Ces variables sont ajoutées sous forme de champs à la classe d’entités en sortie.	String
include_subdirectories (Facultatif)	Spécifie si les fichiers résidant dans les sous-répertoires d’un dossier en entrée sont utilisés. INCLUDE_SUBDIRECTORIES—Tous les fichiers netCDF dans tous les sous-répertoires sont utilisés. DO_NOT_INCLUDE_SUBDIRECTORIES—Seuls les fichiers dans le dossier en entrée sont utilisés. Il s’agit de l’option par défaut.	Boolean
in_cf_metadata (Facultatif)	Fichier au format XML avec une extension .ncml qui fournit les informations CF manquantes ou modifiées pour les fichiers netCDF en entrée.	File
analysis_extent (Facultatif)	La classe Extent détermine l’étendue du jeu de données raster en sortie. La classe Extent se présente comme suit : Extent (XMin, YMin, XMax, YMax) où : XMin : valeur XMin de l’étendue YMin : valeur YMin de l’étendue XMax : valeur XMax de l’étendue YMax : valeur YMax de l’étendue	Extent

Sortie obtenue

Nom	Explication	Type de données
out_point	Classe d’entités ponctuelles en sortie.	Feature Class

Exemple de code

Exemple 1 d’utilisation de l’outil NetCDFPointsToFeatureClass (fenêtre Python)

Cet exemple crée une classe d’entités ponctuelles à partir d’un dossier contenant des fichiers de points DSG netCDF provenant d’un jeu de données SWOT, où les variables se trouvent dans des groupes.

import arcpy
arcpy.md.NetCDFPointsToFeatureClass(r"C:\SWOT", r"C:\ArcGIS\Projects\output.gdb",
                                    "swot_water_frac", "water_frac", 
				    "INCLUDE_SUBDIRECTORIES", None, "DEFAULT")

Exemple 2 d'utilisation de l'outil NetCDFPointsToFeatureClass (script autonome)

Cet exemple crée une classe d’entités à partir d’un ensemble de fichiers de points DSG netCDF provenant de MADIS avec un fichier .ncml.

# Name: NetCDFPointsToFeatureClass_Ex_02.py
# Description: Creates a feature class from a netCDF DSG points file from MADIS with a .ncml file.

# Import system modules
import arcpy

# Set the local variables
in_files_or_folders = r"C:\MADIS"
target_workspace = r"C:\outputs\madis.gdb"
out_point_name = "madis_point"
instance_variables = "temperature;pressure"
include_subdirectories = "DO_NOT_INCLUDE_SUBDIRECTORIES"
in_cf_metadata = r"C:\MADIS\swot_cf.ncml"
analysis_extent = ""

# Execute NetCDFTimeSeriesToFeatureClass
arcpy.md.NetCDFPointsToFeatureClass(in_files_or_folders, target_workspace,
                                    out_point_name, instance_variables,
                                    include_subdirectories, in_cf_metadata,
                                    analysis_extent)

Environnements

Système de coordonnées en sortie, Étendue