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

Synthèse

Crée une couche raster à partir des données stockées sur un serveur OPeNDAP.

Utilisation

  • Les performances de cet outil dépendent de la vitesse du serveur OPeNDAP distant et de l'efficacité de la connexion Internet entre la machine qui exécute l'outil et le serveur distant.

  • Pour créer une couche raster, les coordonnées x et les coordonnées y des données distantes doivent être équidistantes. C'est ce que l'on appelle les données quadrillées de façon régulière.

  • 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
URL OPeNDAP entrante

URL faisant référence au jeu de données OPeNDAP distant. L'URL doit être résolue au niveau du jeu de données (nom de fichier, par exemple), et non d'un nom de répertoire.

File; String
Variable

Variable du jeu de données OPeNDAP qui servira à créer la couche raster.

String
Dimension X

Dimension du jeu de données OPeNDAP utilisé pour définir les coordonnées x (coordonnées de longitude) de la couche raster en sortie.

String
Dimension Y

Dimension du jeu de données OPeNDAP utilisé pour définir les coordonnées y (coordonnées de latitude) de la couche raster en sortie.

String
Couche raster en sortie

Nom de la couche raster en sortie.

Raster Layer
Etendue
(Facultatif)

Étendue en sortie de la couche raster. Spécifiez les coordonnées d’étendue dans les unités de la source de données OPeNDAP (il peut s’agir de la latitude-longitude, de coordonnées projetées ou de coordonnées de grille arbitraires). L'objectif de ce paramètre est de limiter à une zone d'intérêt ou de réduire la taille des données transférées.

Envelope
Valeurs de dimension
(Facultatif)

Valeurs de début et de fin des dimensions ou dimensions utilisées pour contraindre les données à extraire à partir du serveur OPeNDAP distant. Par défaut, les valeurs minimum et maximum de la dimension ou des dimensions sont utilisées.

  • Dimension : dimension netCDF.
  • Valeur de départ : valeur de départ à utiliser pour la dimension spécifiée.
  • Valeur de fin : valeur de fin à 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 la façon dont les cellules sont inscrites eu égard aux coordonnées x,y.

  • CENTERLes coordonnées x,y représentent le centre de la cellule. Il s’agit de l’option par défaut.
  • LOWER_LEFTLes coordonnées x,y représentent l’angle inférieur gauche de la cellule.
  • UPPER_LEFTLes coordonnées x,y représentent l’angle supérieur gauche de la cellule.
String

arcpy.management.MakeOPeNDAPRasterLayer(in_opendap_URL, variable, x_dimension, y_dimension, out_raster_layer, {extent}, {dimension_values}, {value_selection_method}, {cell_registration})
NomExplicationType de données
in_opendap_URL

URL faisant référence au jeu de données OPeNDAP distant. L'URL doit être résolue au niveau du jeu de données (nom de fichier, par exemple), et non d'un nom de répertoire.

File; String
variable

Variable du jeu de données OPeNDAP qui servira à créer la couche raster.

String
x_dimension

Dimension du jeu de données OPeNDAP utilisé pour définir les coordonnées x (coordonnées de longitude) de la couche raster en sortie.

String
y_dimension

Dimension du jeu de données OPeNDAP utilisé pour définir les coordonnées y (coordonnées de latitude) de la couche raster en sortie.

String
out_raster_layer

Nom de la couche raster en sortie.

Raster Layer
extent
(Facultatif)

Étendue en sortie de la couche raster. Spécifiez les coordonnées d’étendue dans les unités de la source de données OPeNDAP (il peut s’agir de la latitude-longitude, de coordonnées projetées ou de coordonnées de grille arbitraires). L'objectif de ce paramètre est de limiter à une zone d'intérêt ou de réduire la taille des données transférées.

Envelope
dimension_values
[[dimension, {start_value}, {end_value}],...]
(Facultatif)

Valeurs de début et de fin des dimensions ou dimensions utilisées pour contraindre les données à extraire à partir du serveur OPeNDAP distant. Par défaut, les valeurs minimum et maximum de la dimension ou des dimensions sont utilisées.

  • dimension : dimension netCDF.
  • {start_value} : valeur de départ à utiliser pour la dimension spécifiée.
  • {end_value} : valeur de fin à 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 la façon dont les cellules sont inscrites eu égard aux coordonnées x,y.

  • CENTERLes coordonnées x,y représentent le centre de la cellule. Il s’agit de l’option par défaut.
  • LOWER_LEFTLes coordonnées x,y représentent l’angle inférieur gauche de la cellule.
  • UPPER_LEFTLes coordonnées x,y représentent l’angle supérieur gauche de la cellule.
String

Exemple de code

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

Crée une couche raster OPeNDAP.

import arcpy
arcpy.md.MakeOPeNDAPRasterLayer("http://cida.usgs.gov/thredds/dodsC/new_gmo", 
				"pr", "longitude", "latitude", "pr_Layer", 
				"-124.6875 25.1875 -67.0625 52.8125", 
				"time '01/01/1949 12:00:00 AM' '12/31/2010 12:00:00 AM'", "BY_VALUE")
Exemple 2 d'utilisation de l'outil MakeOPeNDAPRasterLayer (script autonome)

Crée une couche raster OPeNDAP.

# Name: MakeOPeNDAPRasterLayer_Ex_02.py
# Description: Create an OPeNDAP raster layer from a netCDF file.
# Requirements: None

# Import system modules
import arcpy


# Set local variables
in_opendap_URL = "http://cida.usgs.gov/thredds/dodsC/new_gmo"
variable = "pr"
XDimension = "longitude"
YDimension = "latitude"
outRasterLayer = "pr_Layer"
extent = "-124.6875 25.1875 -67.0625 52.8125"
dimensionValues = "time '01/01/1949 12:00:00 AM' '12/31/2010 12:00:00 AM'"
valueSelectionMethod = "BY_VALUE"
cellRegistration = ""

# Execute MakeNetCDFRasterLayer
arcpy.md.MakeOPeNDAPRasterLayer(in_opendap_URL, variable, XDimension, YDimension,
                               outRasterLayer, extent, dimensionValues, 
                               valueSelectionMethod, cellRegistration)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.