Générer une couche raster NetCDF (Outils multidimensionnels)

Synthèse

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

L’outil Créer une couche raster multidimensionnelle apporte des fonctionnalités ou des performances améliorées.

Utilisation

  • La sortie de cet outil n’est pas prise en charge comme entrée dans de nombreux outils d’exploration, de gestion des données et d’analyse multidimensionnelles. À la place, utilisez la sortie de l’outil Créer une couche raster multidimensionnelle.

  • 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 créer une couche raster netCDF à partir d'une variable netCDF, les coordonnées x et les coordonnées y doivent être équidistantes. Si les coordonnées ne sont pas équidistantes, créez une couche d'entités netCDF, puis interpolez en raster.

  • Le type de la couche raster en sortie est réel simple ou entier en fonction du type de variable netCDF.

  • La première variable du fichier netCDF adaptée à la création d'un raster est sélectionnée en tant que variable par défaut.

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

  • Spécifiez une valeur pour le paramètre Dimension de canal pour créer un raster multicanal.

  • La première valeur d'une dimension non spatiale permet de créer une vue par défaut d'une variable multidimensionnelle.

  • Pour enregistrer la couche en sortie, cliquez avec le bouton droit sur la couche dans la fenêtre Contenu de ArcGIS AllSource, puis sélectionnez Enregistrer comme fichier de couche. Vous pouvez également utiliser l’outil Enregistrer dans un fichier de couche.

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

  • Utilisez le paramètre Cell Registration (Enregistrement de cellule) (cell_registration dans Python) pour déterminer dans quelle mesure la couche raster netCDF est calculée à partir des valeurs de dimension x et y. La taille de cellule, le nombre de lignes et de colonnes, ainsi que la largeur et la hauteur du raster en sortie demeurent identiques, quelle que soit l’option utilisée.

Paramètres

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

Fichier netCDF en entrée.

File
Variable

La variable du fichier netCDF utilisée pour attribuer des valeurs de cellule au raster en sortie. Il s'agit de la variable qui sera affichée, comme la température ou les précipitations.

String
Dimension X

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

String
Dimension Y

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

String
Couche raster en sortie

Nom de la couche raster en sortie.

Raster Layer
Dimension de canal
(Facultatif)

Dimension netCDF utilisée pour créer des canaux dans le raster en sortie. Définissez cette dimension si une couche raster multicanal est nécessaire. Par exemple, l'altitude peut être définie comme dimension de canal pour créer un raster multicanal où chaque canal représente la température à cette altitude.

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
Enregistrement de cellule
(Facultatif)

Spécifie l’emplacement de l’enregistrement de cellule.

  • CENTEREnregistrement de cellule au centre de la cellule. Il s’agit de l’option par défaut.
  • LOWER_LEFTEnregistrement de cellule dans l’angle inférieur gauche de la cellule.
  • UPPER_LEFTEnregistrement de cellule dans l’angle supérieur gauche de la cellule.
String

arcpy.management.MakeNetCDFRasterLayer(in_netCDF_file, variable, x_dimension, y_dimension, out_raster_layer, {band_dimension}, {dimension_values}, {value_selection_method}, {cell_registration})
NomExplicationType de données
in_netCDF_file

Fichier netCDF en entrée.

File
variable

La variable du fichier netCDF utilisée pour attribuer des valeurs de cellule au raster en sortie. Il s'agit de la variable qui sera affichée, comme la température ou les précipitations.

String
x_dimension

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

String
y_dimension

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

String
out_raster_layer

Nom de la couche raster en sortie.

Raster Layer
band_dimension
(Facultatif)

Dimension netCDF utilisée pour créer des canaux dans le raster en sortie. Définissez cette dimension si une couche raster multicanal est nécessaire. Par exemple, l'altitude peut être définie comme dimension de canal pour créer un raster multicanal où chaque canal représente la température à cette altitude.

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

Spécifie l’emplacement de l’enregistrement de cellule.

  • CENTEREnregistrement de cellule au centre de la cellule. Il s’agit de l’option par défaut.
  • LOWER_LEFTEnregistrement de cellule dans l’angle inférieur gauche de la cellule.
  • UPPER_LEFTEnregistrement de cellule dans l’angle supérieur gauche de la cellule.
String

Exemple de code

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

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

import arcpy
arcpy.MakeNetCDFRasterLayer_md("C:/data/netcdf/rainfall.nc","pptx",
                         "lon","lat","rainfall")
Exemple d'utilisation de l'outil MakeNetCDFRasterLayer 2 (script autonome)

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

# Name: MakeNetCDFRasterLayer_Ex_02.py
# Description: Create a raster layer from a netCDF file.
# Requirements: None

# Import system modules
import arcpy


# Set local variables
inNetCDFFile = "C:/data/netcdf/rainfall.nc"
variable = "pptx"
XDimension = "lon"
YDimension = "lat"
outRasterLayer = "rainfall"
bandDimmension = ""
dimensionValues = ""
valueSelectionMethod = ""
cellRegistration = ""

# Execute MakeNetCDFRasterLayer
arcpy.md.MakeNetCDFRasterLayer(inNetCDFFile, variable, XDimension, YDimension,
                               outRasterLayer, bandDimmension, dimensionValues, 
                               valueSelectionMethod, cellRegistration)