Séries chronologiques NetCDF vers classe d’entités (Géométrie d’échantillonnage discret) (Multidimension)

Synthèse

Crée une classe d’entités à partir de séries chronologies dans des fichiers netCDF. Dans la convention des métadonnées des données de climat et de prévision, une série chronologique 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 série chronologique est une série de points de données situés à la même localisation spatiale 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.

  • Une classe d’entités ponctuelles 2D ou 3D contenant toutes les informations de localisation ainsi que les champs d’instance sélectionnés, et une table associée contenant les variables d’observation sélectionnées, seront créées. Une couche facultative peut également être créée. Elle joindra la table à la classe d’entités en fonction du champ InstanceID.
  • 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’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 de jointure en sortie
(Facultatif)

Nom de la table en sortie qui contiendra tous les enregistrements du paramètre 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
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 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
Couche de jointure en sortie
(Facultatif)

Couche en sortie créée en joignant la table en sortie à la classe d’entités en sortie. Cette sortie est facultative.

Feature Layer

Sortie obtenue

ÉtiquetteExplicationType de données
Point en sortie

Classe d’entités ponctuelles en sortie.

Feature Class
Table de jointure en sortie

Table en sortie.

Table

arcpy.md.NetCDFTimeSeriesToFeatureClass(in_files_or_folders, target_workspace, out_point_name, {observation_variables}, {out_table_name}, {instance_variables}, {include_subdirectories}, {in_cf_metadata}, {analysis_extent}, {out_join_layer})
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
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 contiendra tous les enregistrements du paramètre observation_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 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
out_join_layer
(Facultatif)

Couche en sortie créée en joignant la table en sortie à la classe d’entités en sortie. Cette sortie est facultative.

Feature Layer

Sortie obtenue

NomExplicationType de données
out_point

Classe d’entités ponctuelles en sortie.

Feature Class
out_table

Table en sortie.

Table

Exemple de code

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

Cet exemple crée une classe d’entités et une table à partir d’un fichier netCDF de séries chronologiques de géométrie d’échantillonnage discret issu d’un jeu de données de station météorologique.

import arcpy
arcpy.md.NetCDFTimeseriesToFeatureClass(r"C:\WOD\station_Tmax.nc", r"C:\ArcGIS\Projects\output.gdb", 
										"Tmax_1990_2020", "Tmax", None, "Tmax_1990_2020_table", 
										"INCLUDE_SUBDIRECTORIES", None, "DEFAULT", “”)
Exemple 2 d’utilisation de la fonction NetCDFTimeSeriesToFeatureClass (script autonome)

Cet exemple crée une classe d’entités à partir d’un fichier netCDF de séries chronologiques de géométrie d’échantillonnage discret issu de données de réanalyse climatique avec un fichier .ncml.

# Name: NetCDFTimeSeriesToFeatureClass_Ex_02.py
# Description: Creates a feature class from a netCDF DSG timeseries file from ARGO with a .ncml file. 

# Import system modules
Import arcpy  

# Set the local variables 
in_files_or_folders = r"C:\ARGO" 
target_workspace = r"C:\outputs\argo.gdb" 
out_point_name = "argo_point" 
observation_variables = "temperature;pressure" 
out_table_name = "" 
instance_variables = "" 
include_subdirectories = "DO_NOT_INCLUDE_SUBDIRECTORIES" 
in_cf_metadata = "ARGO_cf.ncml" 
analysis_extent = "" 
out_join_layer = "" 

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

Informations de licence

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

Rubriques connexes