Générer une vue tabulaire NetCDF (Outils multidimensionnels)

Synthèse

Génère une vue tabulaire à partir d'un fichier netCDF.

Utilisation

  • Les vues tabulaires sont des tables stockées en mémoire. Elles sont similaires aux tables autonomes dans la fenêtre Contenu d'ArcGIS Pro.

  • Les vues tabulaires peuvent être utilisées en tant qu’entrées d’autres outils de géotraitement dans la session Windows courante. Lors de la fermeture de Windows, les tables en mémoire sont supprimées. Pour enregistrer la vue tabulaire dans une table permanente pouvant être utilisée dans les sessions Windows ultérieures, utilisez l’outil Copier des enregistrements.

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

  • Une vue tabulaire existante est remplacée si le même nom de vue tabulaire est entré.

  • Le nombre d'enregistrements de la vue tabulaire 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.

  • La table en sortie contient un seul enregistrement si aucune dimension de lignes n'est spécifiée. Les valeurs dans les champs représentent la tranche spécifiée par les paires dimension-valeur.

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

  • La première valeur d'une dimension ne correspondant pas à une ligne permet de créer une vue tabulaire 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.

  • Les valeurs représentées par les attributs missing_value ou _FillValue d’une variable dans un fichier netCDF est nulle dans la vue tabulaire en sortie.

Paramètres

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

Fichier netCDF en entrée.

File
Variables

Variable(s) netCDF utilisée(s) pour créer des champs dans la vue tabulaire.

String
Vue tabulaire en sortie

Nom de la vue tabulaire en sortie.

Table View
Dimensions de lignes
(Facultatif)

Dimension(s) netCDF utilisée(s) pour créer des champs comprenant des valeurs uniques dans la vue tabulaire. Les dimensions définies ici déterminent le nombre de lignes de la vue tabulaire et les champs qu'elle comprend.

Par exemple, si StationID est une dimension dans le fichier netCDF possédant 10 valeurs, en définissant StationID comme dimension à utiliser, 10 lignes seront créées dans la vue tabulaire. Si stationID et le temps sont utilisés et qu'il existe 3 tranches de temps, 30 lignes sont créées dans la vue tabulaire.

String
Valeurs de dimension
(Facultatif)

Jeu de paires dimension-valeur utilisé pour spécifier une tranche d'une variable multidimensionnelle.

  • 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.MakeNetCDFTableView(in_netCDF_file, variable, out_table_view, {row_dimension}, {dimension_values}, {value_selection_method})
NomExplicationType de données
in_netCDF_file

Fichier netCDF en entrée.

File
variable
[variable,...]

Variable(s) netCDF utilisée(s) pour créer des champs dans la vue tabulaire.

String
out_table_view

Nom de la vue tabulaire en sortie.

Table View
row_dimension
[row_dimension,...]
(Facultatif)

Dimension(s) netCDF utilisée(s) pour créer des champs comprenant des valeurs uniques dans la vue tabulaire. Les dimensions définies ici déterminent le nombre de lignes de la vue tabulaire et les champs qu'elle comprend.

Par exemple, si StationID est une dimension dans le fichier netCDF possédant 10 valeurs, en définissant StationID comme dimension à utiliser, 10 lignes seront créées dans la vue tabulaire. Si stationID et le temps sont utilisés et qu'il existe 3 tranches de temps, 30 lignes sont créées dans la vue tabulaire.

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

Jeu de paires dimension-valeur utilisé pour spécifier une tranche d'une variable multidimensionnelle.

  • 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 MakeNetCDFTableView 1 (fenêtre Python)

Crée une vue tabulaire à partir d'un fichier netCDF.

import arcpy
arcpy.MakeNetCDFTableView_md("C:/data/netcdf/precipmonmean.nc","precip",
                             "precipmonmeantable","time")
Exemple d'utilisation de l'outil MakeNetCDFTableView 2 (script autonome)

Crée une vue tabulaire à partir d'un fichier netCDF.

# MakeNetCDFTableView_Ex_02.py
# Description: Create a table view from a netCDF file.
# Requirements: None

#Import system modules
import arcpy

# Set local variables
inNetCDFFile = "c:/data/netcdf/precipmonmean.nc"
variable = "precip;humidity"
outTableView = "precipmonmeantable"
rowDimension = "time"
dimensionValue = ""
valueSelectionMethod = ""

# Execute MakeNetCDFTableView
arcpy.MakeNetCDFTableView_md(inNetCDFFile, variable, outTableView, rowDimension, 
                             dimensionValue,valueSelectionMethod)