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

Résumé

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

Utilisation

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

Syntaxe

arcpy.md.MakeNetCDFFeatureLayer(in_netCDF_file, variable, x_variable, y_variable, out_feature_layer, {row_dimension}, {z_variable}, {m_variable}, {dimension_values}, {value_selection_method})
ParamètreExplicationType 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 (telle que Time) 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 valeur de dimension allant être utilisée.

  • BY_VALUELa valeur en entrée est mise en correspondance avec la valeur de dimension réelle.
  • BY_INDEXLa valeur en entrée est mise en correspondance 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)

Informations de licence

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

Rubriques connexes