Trajectoires 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 séries trajectoires dans des fichiers netCDF. Dans la convention des métadonnées des données de climat et de prévision, une trajectoire est un type de géométrie d’échantillonnage discret (DSG).

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

Utilisation

  • Dans la convention des métadonnées des données de climat et de prévision, une trajectoire est une série de points de données sur un chemin à travers l’espace avec des dates/heures qui augmentent de manière monotone.

  • 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.

  • Un type d’entité de géométrie d’échantillonnage discret est identifié par une variable ID d’instance marquée par un attribut cf_role. Il est possible de convertir plusieurs fichiers netCDF de même structure en une seule classe d’entités avec un champ InstanceID unique. Chaque fichier netCDF doit disposer d’une variable marquée par le même attribut cf_role qui servira de champ d’identification dans plusieurs fichiers. L’agrégation aura lieu strictement le long de la dimension d’instance de cette variable.

  • Pour les variables d’instance et d’observation, l’appariement se produit 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 et d’observation (numéro de croisière, température, salinité, etc.) peuvent être sélectionnées dans les paramètres Instance Variable (Variables d’instance) (instance_variables dans Python) et Observation Variables (Variables d’observation) (observation_variables dans Python), respectivement.

  • 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.

  • Lorsque l’option Itinéraire et événement est spécifiée pour le paramètre Structure en sortie (out_schema = "ROUTE_AND_EVENT" dans Python), deux sorties sont générées. L’une est une entité polyligne 2D ou 3D illustrant le chemin de la trajectoire, avec les champs From Time et To Time indiquant la date/l’heure de début et de fin de chaque trajectoire. L’autre sortie est une table avec des valeurs d’observation à chaque date/heure d’enregistrement et des champs temporels associés. Lorsque l’option Point est spécifiée (out_schema = "POINT" dans Python), une couche d’entités ponctuelles 2D ou 3D qui illustre les localisations sur chaque trajectoire où des observations sont réalisées 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 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 ou de polyligne 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’observation
(Facultatif)

Variables netCDF contenant toutes les valeurs d’observation à chaque localisation et chaque niveau vertical. Elles sont ajoutées sous forme de champs à la table en sortie.

String
Nom de la table d’événements en sortie
(Facultatif)

Nom de la table en sortie qui contient tous les enregistrements des variables d’observation.

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
Structure en sortie
(Facultatif)

Indique le type de classe d’entités en sortie à créer.

  • Itinéraire et événementUne classe d’entités polylignes 2D ou 3D illustrant les informations de chemin est créée.
  • PointUne classe d’entités 2D ou 3D illustrant toutes les localisations où des observations sont réalisées est créée.
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 ou polyligne en sortie

Classe d’entités ponctuelles ou polylignes en sortie.

Feature Class
Table d’événements en sortie

Table en sortie.

Table

arcpy.management.NetCDFTrajectoriesToFeatureClass(in_files_or_folders, target_workspace, out_point_or_polyline_name, {observation_variables}, {out_table_name}, {instance_variables}, {out_schema}, {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_or_polyline_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
observation_variables
[observation_variables,...]
(Facultatif)

Variables netCDF contenant toutes les valeurs d’observation à chaque localisation et chaque niveau vertical. Elles sont ajoutées sous forme de champs à la table en sortie.

String
out_table_name
(Facultatif)

Nom de la table en sortie qui contient tous les enregistrements des variables d’observation.

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
out_schema
(Facultatif)

Indique le type de classe d’entités en sortie à créer.

  • ROUTE_AND_EVENTUne classe d’entités polylignes 2D ou 3D illustrant les informations de chemin est créée.
  • POINTUne classe d’entités 2D ou 3D illustrant toutes les localisations où des observations sont réalisées est créée.
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_or_polyline

Classe d’entités ponctuelles ou polylignes en sortie.

Feature Class
out_table

Table en sortie.

Table

Exemple de code

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

Cet exemple crée une classe d’entités et une table à partir d’un fichier netCDF de trajectoires de géométrie d’échantillonnage discret issu de l’agence américaine d'observation océanique et atmosphérique (NOAA).

import arcpy
arcpy.md.NetCDFTrajectoriesToFeatureClass(r"C:\AMLR\amlr_202002160447.nc", r"C:\ArcGIS\Projects\output.gdb", 
										  "amlr", "temperature", None, "amrl_table", "ROUTE_AND_EVENT", 
										  "INCLUDE_SUBDIRECTORIES", None, "DEFAULT")
Exemple 2 d’utilisation de la fonction NetCDFTrajectoriesToFeatureClass (script autonome)

Cet exemple crée une classe d’entités et une table à partir d’un fichier netCDF de trajectoires de géométrie d’échantillonnage discret représentant les traces d’ouragans.

# Name: NetCDFTrajectoriesToFeatureClass_Ex_02.py
# Description: Creates a polyline feature class from a netCDF DSG trajectories file of hurricane track. 

# Import system modules
Import arcpy  

# Set the local variables 
in_files_or_folders = r"C:\IBTrACS\Katrina"  
target_workspace = r"C:\outputs\hurricane.gdb" 
out_point_or_polyline_name = "Katrina_2005" 
observation_variables = "wind_speed" 
out_table_name = "" 
instance_variables = "" 
out_schema = "ROUTE_AND_EVENT" 
include_subdirectories = "DO_NOT_INCLUDE_SUBDIRECTORIES" 
in_cf_metadata = "" 
analysis_extent = "" 

# Execute NetCDFTrajectoriesToFeatureClass
arcpy.md.NetCDFTrajectoriesToFeatureClass(in_files_or_folders, target_workspace,
                                      out_point_or_polyline_name, observation_variables,
                                      out_table_name, instance_variables, out_schema,
                                      include_subdirectories, in_cf_metadata,
                                      analysis_extent)