Générer une couche raster OPeNDAP (Multidimension)

Résumé

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 X Dimension et Y Dimension. 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.

Syntaxe

arcpy.md.MakeOPeNDAPRasterLayer(in_opendap_URL, variable, x_dimension, y_dimension, out_raster_layer, {extent}, {dimension_values}, {value_selection_method}, {cell_registration})
ParamètreExplicationType 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 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
cell_registration
(Facultatif)

Spécifie la façon dont les cellules sont inscrites eu égard aux coordonnées XY.

  • CENTERLes coordonnées XY représentent le centre de la cellule. Il s’agit de l’option par défaut.
  • LOWER_LEFTLes coordonnées XY représentent le coin inférieur gauche de la cellule.
  • UPPER_LEFTLes coordonnées XY représentent le coin 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.MakeOPeNDAPRasterLayer_md(in_opendap_URL, variable, XDimension, YDimension,
                               outRasterLayer, extent, dimensionValues, 
                               valueSelectionMethod, cellRegistration)

Environnements

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

Informations de licence

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

Rubriques connexes