Générer une couche d’entités NetCDF (Outils multidimensionnels)

Synthèse

Génère une couche d'entités à partir d'un fichier netCDF.

Utilisation

  • Cet outil prend en charge les fichiers netCDF avec l’extension .nc ou .nc4. Les variables du groupe et les dimensions au sein d’un groupe dans un fichier .nc4 ne sont pas prises en charge. Seules les variables et les dimensions en dehors du groupe sont prises en charge.

  • Pour des fichiers netCDF volumineux, un délai entre la fin de l'exécution de l'outil et le début de l'affichage de la couche netCDF peut se produire. En revanche, le prochain affichage de la couche est immédiat.

  • Vous pouvez utiliser la couche d'entités netCDF en entrée de tout outil de géotraitement acceptant une classe d'entités en entrée.

  • La couche d'entités temporaire peut être enregistrée en tant que fichier de couche à l'aide de l'outil Enregistrer dans un fichier de couche ou enregistrée en tant que nouvelle classe d'entités à l'aide de l'outil Copier des entités.

  • Une couche d'entités existante est remplacée si vous spécifiez le même nom de couche.

  • Les variables de coordonnées auxiliaires sont répertoriées dans les listes déroulantes Variable X et Variable Y et utilisées pendant l'exécution, le cas échéant. Elles ne figurent pas dans la liste déroulante du paramètre Valeurs de dimension et ne peuvent pas être définies comme valeur de ce paramètre sur la ligne de commande ou dans un script.

  • Le nombre d'entités de la couche est identique au nombre de valeurs uniques dans la dimension de lignes. Si plusieurs dimensions sont sélectionnées, le nombre d'enregistrements correspond au produit du nombre de valeurs uniques dans ces dimensions.

  • Une seule entité est créée si une dimension de lignes n'est pas spécifiée.

  • Le type de champ est déterminé par le type de variable netCDF.

  • La première valeur d'une dimension ne correspondant pas à une ligne permet de créer une vue par défaut d'une variable multidimensionnelle.

  • Les valeurs attributaires de calendrier noleap et 365_day, affectées à la variable de coordonnée de temps du fichier netCDF, ne sont pas respectées dans ArcGIS.

Paramètres

ÉtiquetteExplicationType de données
Fichier NetCDF en entrée

Fichier netCDF en entrée.

File
Variables

Variable(s) netCDF à ajouter à la table attributaire des entités sous forme de champs.

String
Variable X

Variable de coordonnée netCDF utilisée pour définir les coordonnées x (coordonnées de longitude) de la couche en sortie.

String
Variable Y

Variable de coordonnée netCDF utilisée pour définir les coordonnées y (ou coordonnées de latitude) de la couche en sortie.

String
Couche d’entités en sortie

Nom de la couche d'entités en sortie.

Feature Layer
Dimensions de lignes
(Facultatif)

Dimension(s) netCDF utilisée(s) pour créer des entités ayant des valeurs uniques dans la couche d'entités. Les dimensions définies ici déterminent le nombre d'entités de la couche d'entités et les champs qui seront présentés dans la table attributaire de la couche d'entités.

Par exemple, si StationID est une dimension dans le fichier netCDF possédant 10 valeurs, en définissant StationID comme dimension à utiliser, 10 entités sont créées (10 lignes sont créées dans la table attributaire de la couche d'entités). Si StationID et le temps sont utilisés et qu'il existe 3 tranches de temps, 30 entités sont créées (30 lignes sont créées dans la table attributaire de la couche d'entités). Si vous comptez animer la couche d'entités netCDF, il est recommandé de ne pas définir le temps comme dimension pour des questions d'efficacité. Cette dimension restera disponible pour l'animation, mais la table attributaire ne stockera pas cette information.

String
Variable Z
(Facultatif)

Variable netCDF utilisée pour spécifier les valeurs d'altitude (valeurs z) des entités.

String
Variable M
(Facultatif)

Variable netCDF utilisée pour spécifier les valeurs de mesure linéaire (valeurs m) des entités.

String
Valeurs de dimension
(Facultatif)

La valeur (telle que 01/30/05) de la dimension (le temps, par exemple) ou des dimensions à utiliser lors de l’affichage de la variable dans la couche en sortie. Par défaut, la première valeur de la dimension ou des dimensions est utilisée.

  • Dimension : dimension netCDF.
  • Value (Valeur) : valeur de dimension à utiliser.
Value Table
Méthode de sélection de valeurs
(Facultatif)

Spécifie la méthode de sélection de la valeur de dimension à appliquer.

  • Par valeurLa valeur en entrée sera appariée avec la valeur de dimension réelle.
  • Par indexLa valeur en entrée sera appariée avec la position ou le numéro d’index d’une valeur de dimension. L'index est basé sur 0, ce qui signifie que la première position est 0.
String

arcpy.management.MakeNetCDFFeatureLayer(in_netCDF_file, variable, x_variable, y_variable, out_feature_layer, {row_dimension}, {z_variable}, {m_variable}, {dimension_values}, {value_selection_method})
NomExplicationType de données
in_netCDF_file

Fichier netCDF en entrée.

File
variable
[variable,...]

Variable(s) netCDF à ajouter à la table attributaire des entités sous forme de champs.

String
x_variable

Variable de coordonnée netCDF utilisée pour définir les coordonnées x (coordonnées de longitude) de la couche en sortie.

String
y_variable

Variable de coordonnée netCDF utilisée pour définir les coordonnées y (ou coordonnées de latitude) de la couche en sortie.

String
out_feature_layer

Nom de la couche d'entités en sortie.

Feature Layer
row_dimension
[row_dimension,...]
(Facultatif)

Dimension(s) netCDF utilisée(s) pour créer des entités ayant des valeurs uniques dans la couche d'entités. Les dimensions définies ici déterminent le nombre d'entités de la couche d'entités et les champs qui seront présentés dans la table attributaire de la couche d'entités.

Par exemple, si StationID est une dimension dans le fichier netCDF possédant 10 valeurs, en définissant StationID comme dimension à utiliser, 10 entités sont créées (10 lignes sont créées dans la table attributaire de la couche d'entités). Si StationID et le temps sont utilisés et qu'il existe 3 tranches de temps, 30 entités sont créées (30 lignes sont créées dans la table attributaire de la couche d'entités). Si vous comptez animer la couche d'entités netCDF, il est recommandé de ne pas définir le temps comme dimension pour des questions d'efficacité. Cette dimension restera disponible pour l'animation, mais la table attributaire ne stockera pas cette information.

String
z_variable
(Facultatif)

Variable netCDF utilisée pour spécifier les valeurs d'altitude (valeurs z) des entités.

String
m_variable
(Facultatif)

Variable netCDF utilisée pour spécifier les valeurs de mesure linéaire (valeurs m) des entités.

String
dimension_values
[[dimension, {value}],...]
(Facultatif)

La valeur (telle que 01/30/05) de la dimension (le temps, par exemple) ou des dimensions à utiliser lors de l’affichage de la variable dans la couche en sortie. Par défaut, la première valeur de la dimension ou des dimensions est utilisée.

  • dimension : dimension netCDF.
  • {value} : valeur de dimension à utiliser.
Value Table
value_selection_method
(Facultatif)

Spécifie la méthode de sélection de la valeur de dimension à appliquer.

  • BY_VALUELa valeur en entrée sera appariée avec la valeur de dimension réelle.
  • BY_INDEXLa valeur en entrée sera appariée avec la position ou le numéro d’index d’une valeur de dimension. L'index est basé sur 0, ce qui signifie que la première position est 0.
String

Exemple de code

Exemple d'utilisation de l'outil MakeNetCDFFeatureLayer 1 (fenêtre Python)

Crée une couche d'entités à partir d'un fichier netCDF.

import arcpy
arcpy.MakeNetCDFFeatureLayer_md("C:/data/netcdf/rainfall.nc",
                                "pptx","longitude","latitude","rainfall",
                                "station")
Exemple d'utilisation de l'outil MakeNetCDFFeatureLayer 2 (script autonome)

Crée une couche d'entités à partir d'un fichier netCDF.

# MakeNetCDFFeatureLayer_Ex_02.py
# Description: Create a feature layer from a netCDF file.
# Requirements: None

# Import system modules
import arcpy

# Set local variables
inNetCDFFile = "C:/data/netcdf/rainfall.nc"
inVariables = "pptx"
inXVariable = "longitude"
inYVariable = "latitude"
outFeatureLayer = "rainfall"
rowDimensions = "station"
ZVariable = ""
MVariable = ""
dimensionValues = ""
valueSelectionMethod = ""

#Execute MakeNetCDFFeatureLayer
arcpy.MakeNetCDFFeatureLayer_md(inNetCDFFile, inVariables, inXVariable, 
                                inYVariable, outFeatureLayer, rowDimensions, 
                                ZVariable, MVariable, dimensionValues, 
                                valueSelectionMethod)