Sélectionner par dimension (Outils multidimensionnels)

Synthèse

Met à jour l'affichage d'une couche netCDF ou une vue tabulaire netCDF en fonction d'une valeur de dimension.

Utilisation

  • L’entrée de cet outil peut être une couche raster netCDF, une couche d’entités netCDF, une vue tabulaire netCDF, une couche de mosaïque ou un service d’imagerie. Si l’entrée est une couche de mosaïque ou une couche de service d’imagerie, des informations multidimensionnelles doivent lui être associées.

    Les entrées pour cet outil peuvent être créées à l'aide des outils Générer une couche d’entités NetCDF, Générer une couche raster NetCDF, Créer une couche de mosaïque, Créer une couche de serveur d'imagerie ou Générer une vue tabulaire NetCDF.

  • Si une dimension n'est pas spécifiée, sa valeur est définie sur la première valeur. La première valeur est considérée comme valeur par défaut.

  • Pour les couches netCDF, les variables des coordonnées auxiliaires ne sont pas répertorié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.

  • L'option met en correspondance la valeur en entré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.

  • Cet outil met à jour l'entrée. Dans ModelBuilder une variable en sortie apparaît, permettant d'enchaîner l'entrée mise à jour comme entrée d'un autre outil dans le modèle (qui ne produit pas de nouvelle sortie).

Paramètres

ÉtiquetteExplicationType de données
Couche ou table en entrée

Couche raster netCDF, couche d'entités netCDF, vue tabulaire netCDF ou couche de mosaïque en entrée. Si l'entrée est une couche de mosaïque, elle doit être multidimensionnelle.

Raster Layer; Feature Layer; Table View; Mosaic Layer
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 indiquant une tranche d’une variable multidimensionnelle.
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

Sortie obtenue

ÉtiquetteExplicationType de données
Couche ou table mise à jour

Entrée mise à jour.

Couche raster ; Couche d’entités ; Vue tabulaire

arcpy.management.SelectByDimension(in_layer_or_table, {dimension_values}, {value_selection_method})
NomExplicationType de données
in_layer_or_table

Couche raster netCDF, couche d'entités netCDF, vue tabulaire netCDF ou couche de mosaïque en entrée. Si l'entrée est une couche de mosaïque, elle doit être multidimensionnelle.

Raster Layer; Feature Layer; Table View; Mosaic Layer
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 indiquant une tranche d’une variable multidimensionnelle.
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

Sortie obtenue

NomExplicationType de données
output_layer_or_table

Entrée mise à jour.

Couche raster ; Couche d’entités ; Vue tabulaire

Exemple de code

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

Met à jour la couche selon la valeur de dimension.

import arcpy
arcpy.SelectByDimension_md("rainfall",[["lat", 20]],"BY_VALUE")
Exemple d'utilisation de l'outil SelectByDimension 2 (script autonome)

Met à jour la couche selon la valeur de dimension.

# Name: SelectBydimension_Ex_02.py
# Description: Updates the netCDF layer display based on the dimension value.
# Requirements: none

# Import system modules
import arcpy

# Set local variables
inNetCDFLayer = "rainfall" 
valueSelect01 = ["lat", 20]
valueSelect02 = ["lon", 45]  
dimensionValues = [valueSelect01, valueSelect02]
valueSelectionMethod = ""

# Execute SelectByDimension
arcpy.SelectByDimension_md(inNetCDFLayer, dimensionValues, valueSelectionMethod)

Environnements

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