Raster vers NetCDF (Outils multidimensionnels)

Synthèse

Convertit un jeu de données raster en fichier netCDF.

Utilisation

  • Le jeu de données raster en entrée peut correspondre à tout jeu de données raster valide.

  • Le nom de variable par défaut est identique au nom du raster en entrée.

  • Le type de variable netCDF en sortie est réel simple ou entier en fonction du type de jeu de données raster en entrée.

  • Les noms des dimensions x et y par défaut sont respectivement x et y.

  • Le paramètre Band Dimension (Dimension de canal) est seulement applicable à un raster multicanal en entrée.

  • Les champs de type chaîne ne peuvent pas être utilisés pour créer des dimensions dans le fichier netCDF.

  • Un niveau de compression élevé réduit la taille du fichier en sortie et peut améliorer les performances de l’outil. Lorsque le fichier netCDF compressé est utilisé en tant qu’entrée à des fins d’analyse supplémentaire, ses performances sont généralement supérieures.

  • L’outil écrit la variable au format de données carroyées régulièrement espacées, conformément aux conventions CFLien vers le site Web des conventions CF. Ainsi, la variable du fichier netCDF en sortie permet la création d’une couche voxel.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Le jeu de données raster en entrée.

Raster Layer
Fichier NetCDF en sortie

Fichier netCDF en sortie. Le nom de fichier doit avoir une extension .nc.

File
Variable
(Facultatif)

Nom de la variable netCDF utilisée dans le fichier netCDF en sortie. Cette variable contient les valeurs des cellules du raster en entrée.

String
Unités des variables
(Facultatif)

Unités des données contenues dans la variable. Le nom de la variable est spécifié par le paramètre Variable.

String
Dimension X
(Facultatif)

Nom de la dimension netCDF qui sera utilisée pour spécifier les coordonnées x (coordonnées de longitude).

String
Dimension Y
(Facultatif)

Nom de la dimension netCDF qui sera utilisée pour spécifier les coordonnées y (coordonnées de latitude).

String
Dimension de canal
(Facultatif)

Nom de la dimension netCDF qui sera utilisée pour spécifier les canaux.

String
Champs vers dimensions
(Facultatif)

Champ(s) utilisé(s) pour créer des dimensions dans le fichier netCDF.

  • Champ : champ dans la table attributaire de raster en entrée.
  • Dimension : nom de la dimension netCDF.
  • Units (Unités) : unités des données représentées par le champ.
Value Table
Niveau de compression
(Facultatif)

Niveau auquel le fichier netCDF en sortie sera compressé. La valeur par défaut est 0, ce qui équivaut à l’absence de compression. Une valeur de 9 implique une compression maximale.

Long

arcpy.management.RasterToNetCDF(in_raster, out_netCDF_file, {variable}, {variable_units}, {x_dimension}, {y_dimension}, {band_dimension}, {fields_to_dimensions}, {compression_level})
NomExplicationType de données
in_raster

Le jeu de données raster en entrée.

Raster Layer
out_netCDF_file

Fichier netCDF en sortie. Le nom de fichier doit avoir une extension .nc.

File
variable
(Facultatif)

Nom de la variable netCDF utilisée dans le fichier netCDF en sortie. Cette variable contient les valeurs des cellules du raster en entrée.

String
variable_units
(Facultatif)

Unités des données contenues dans la variable. Le nom de la variable est spécifié par le paramètre Variable.

String
x_dimension
(Facultatif)

Nom de la dimension netCDF qui sera utilisée pour spécifier les coordonnées x (coordonnées de longitude).

String
y_dimension
(Facultatif)

Nom de la dimension netCDF qui sera utilisée pour spécifier les coordonnées y (coordonnées de latitude).

String
band_dimension
(Facultatif)

Nom de la dimension netCDF qui sera utilisée pour spécifier les canaux.

String
fields_to_dimensions
[[field, {dimension}, {units}],...]
(Facultatif)

Champ(s) utilisé(s) pour créer des dimensions dans le fichier netCDF.

  • field : champ dans la table attributaire de raster en entrée.
  • {dimension} : nom de la dimension netCDF.
  • {units} : unités des données représentées par le champ.
Value Table
compression_level
(Facultatif)

Niveau auquel le fichier netCDF en sortie sera compressé. La valeur par défaut est 0, ce qui équivaut à l’absence de compression. Une valeur de 9 implique une compression maximale.

Long

Exemple de code

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

Convertit un jeu de données raster en fichier netCDF.

import arcpy
arcpy.md.RasterToNetCDF("C:/data/elevation","C:/output/elev.nc","elevation",
                        "meter","x","y", "", "")
Exemple d'utilisation de l'outil RasterToNetCDF 2 (script autonome)

Convertit un jeu de données raster en fichier netCDF.

# RasterToNetCDF_Ex_02.py
# Description: Converts a raster dataset to a netCDF file.
# Requirements: None

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inRaster = "C:/data/elevation"
outNetCDFFile = "C:/output/elevnetcdf.nc"
variable = "elevation"
units = "meter"
XDimension = "x"
YDimension = "y"
bandDimension = ""
compressionLevel = ""

# Process: RasterToNetCDF
arcpy.md.RasterToNetCDF(inRaster, outNetCDFFile, variable, units, 
                        XDimension, YDimension, bandDimension, compressionLevel)