ArcMap

Echantillon

Disponible avec une licence Spatial Analyst.

Résumé

Crée une table indiquant les valeurs de cellules d'un raster ou d'un jeu de rasters, pour des localisations définies. Les localisations sont définies par des cellules raster ou par un ensemble de points.

Les rasters en entrée peuvent être bidimensionnels ou multidimensionnels. La structure de la table en sortie change lorsque les rasters en entrée sont multidimensionnels.

Pour en savoir plus sur le Fonctionnement de l'outil Echantillon

Utilisation

  • Lorsque la localisation en entrée est un raster, l'ensemble des cellules de la localisation correspond aux cellules dont la valeur est supérieure ou égale à zéro. Les cellules associées à la valeur NoData ne figurent pas dans l'ensemble des cellules de la localisation. Vous pouvez facilement créer un raster de localisation à l'aide des outils d'extraction.

  • Les localisations qui échantillonnent les cellules NoData dans le ou les rasters en entrée auront la valeur <null> dans une table de géodatabase en sortie. Dans le cas d'une sortie vers INFO ou .dbf, puisque le concept de valeur Null n'est pas pris en charge, la valeur -9999 est attribuée.

  • Si plusieurs rasters multidimensionnels sont fournis, ils doivent tous partager les mêmes noms de dimension.

  • Les couches raster NetCDF sont les seuls types de rasters multidimensionnels pris en charge.

  • Si les rasters en entrée regroupent des rasters bidimensionnels et multidimensionnels, seule la tranche actuelle d'un raster multidimensionnel sera échantillonnée.

  • Lorsque les rasters en entrée sont bidimensionnels, le type de champ des valeurs échantillonnées dans la table en sortie est toujours à virgule flottante. Cela permet de s'assurer que le degré de précision approprié est conservé si les options bilinéaires ou cubiques étaient sélectionnées pour la méthode de rééchantillonnage.

  • Lorsque l'emplacement en entrée est de type raster, pour de meilleurs résultats, la taille de cellule et l'inscription des rasters en entrée et du raster de localisation doivent être identiques.

  • La sortie de l'outil est une table.

  • Les jeux de données multipoints ne sont pas pris en charge en entrée.

  • Pour plus d'informations sur les environnements de géotraitement qui s'appliquent à cet outil, reportez-vous à la rubrique Environnements d'analyse et Spatial Analyst.

Syntaxe

Sample (in_rasters, in_location_data, out_table, {resampling_type}, {unique_id_field}, {process_as_multidimensional})
ParamètreExplicationType de données
in_rasters
[in_raster,...]

Liste des rasters dont les valeurs sont échantillonnées en fonction des données de localisation en entrée.

Raster Layer
in_location_data

Données identifiant les positions où vous souhaitez procéder à un échantillonnage.

Il peut s'agir d'un raster ou d'un jeu de données d'entité ponctuelles.

Raster Layer; Feature Layer
out_table

Table en sortie contenant les valeurs de cellules échantillonnées.

Le format de la table est déterminé par l'emplacement et le chemin d'accès en sortie. Par défaut, la sortie sera une table de géodatabase. Si le chemin ne se trouve pas dans une géodatabase, le format est déterminé par l'extension. Si l'extension est .dbf, le format est dBASE. Si aucune extension n'est spécifiée, la sortie sera une table INFO.

Table
resampling_type
(Facultatif)

Algorithme de rééchantillonnage utilisé lors de l'échantillonnage d'un raster.

  • NEAREST — Affectation par le voisin le plus proche
  • BILINEAR — Interpolation bilinéaire
  • CUBIC — Convolution cubique
String
unique_id_field
(Facultatif)

Champ qui contient une valeur différente pour chaque localisation ou entité du raster de localisation ou des entités ponctuelles en entrée.

Field
process_as_multidimensional
(Facultatif)

Détermine le mode de traitement des rasters en entrée.

  • ALL_SLICES — Les échantillons proviendront de toutes les dimensions (temps ou profondeur, par exemple) d'un jeu de données muldimensionnelles.
  • CURRENT_SLICE —Les échantillons proviendront de la tranche actuelle d'un jeu de données muldimensionnelles. Il s'agit de l'option par défaut.
Boolean

Exemple de code

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

Extraire les valeurs de cellule de plusieurs rasters vers une table, en fonction de localisations en entrée.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
Sample(["elevation", "costraster"], "observers.shp",
       "c:/sapyexamples/output/samptable","NEAREST")
Exemple 2 d'utilisation de l'outil Sample (script autonome)

Extraire les valeurs de cellule de plusieurs rasters vers une table, en fonction de localisations en entrée.

# Name: Sample_Ex_02.py
# Description: Creates a table that shows the values of cells from 
#              a raster, or set of rasters, for defined locations. 
#              The locations are defined by raster cells or by a set 
#              of points.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

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

# Set local variables
inRasters = ["elevation",
             "costraster"]
locations = "observers.shp"
outTable = "c:/sapyexamples/output/samptable02"
sampMethod = "NEAREST"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Sample
Sample(inRasters, locations, outTable, sampMethod)

Environnements

Informations de licence

  • ArcGIS Desktop Basic: Requiert Spatial Analyst
  • ArcGIS Desktop Standard: Requiert Spatial Analyst
  • ArcGIS Desktop Advanced: Requiert Spatial Analyst

Rubriques connexes