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 dans laquelle les données sont échantillonnées.

  • Les fichiers netCDF en entrée doivent être conformes à la convention sur le climat et la prévision (CF 1.6 ou version ultérieure). Les conventions sur le climat et la prévision définissent les métadonnées pour décrire 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 prolongent ou remplacent les métadonnées du fichier netCDF. Le fichier Input Climate and Forecast Metadata (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 n’en possède pas.

  • Il est possible de convertir plusieurs fichiers de points DSG netCDF 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.

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

  • Vous pouvez utiliser le paramètre Analysis Extent (É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 Analysis Extent (É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 sera créée contenant toutes les informations de localisation ainsi que les valeurs des données pour le paramètre Instance Variables (Variables d'instance) (instance_variables dans Python) sélectionné.

  • Une variable de données dans le fichier netCDF peut utiliser une variable grid_mapping pour définir explicitement le système de référence de coordonnées 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 zéro des marées 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, Instantaneous Water Level Depth ou Height (epsg:5831, epsg:5829) est sélectionné par défaut.

Paramètres

ÉtiquetteExplicationType 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 avoir la même structure et le même type d’entité DSG.

Folder; File
Espace de travail cible

Géodatabase d’entreprise ou fichier dans laquelle la classe d’entités et la table en sortie sont créées. Il doit s’agit d’un espace de travail existant.

Workspace
Nom de point en sortie

Nom de la classe d’entités qui contient les localisations issues des variables netCDF. Ces variables sont ajoutées sous forme de champs à partir du paramètre Instance Variables (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 des 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
Etendue d’analyse
(Facultatif)

Étendue qui définit la zone de la classe d’entités en sortie.

Extent

Sortie obtenue

ÉtiquetteExplicationType de données
Point en sortie

Classe d’entités ponctuelles en sortie.

Feature Class

arcpy.management.NetCDFPointsToFeatureClass(in_files_or_folders, target_workspace, out_point_name, {instance_variables}, {include_subdirectories}, {in_cf_metadata}, {analysis_extent})
NomExplicationType 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 avoir la même structure et le même type d’entité DSG.

Folder; File
target_workspace

Géodatabase d’entreprise ou fichier dans laquelle la classe d’entités et la table en sortie sont créées. Il doit s’agit d’un espace de travail existant.

Workspace
out_point_name

Nom de la classe d’entités qui contient les localisations issues 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_SUBDIRECTORIESTous les fichiers netCDF des sous-répertoires sont utilisés.
  • DO_NOT_INCLUDE_SUBDIRECTORIESSeuls 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 forme de la classe Extent est la suivante :

  • 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

NomExplicationType 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

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)