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
Vous pouvez définir n'importe quelle combinaison de rasters (monocanal ou multicanal) en entrée.
Vous pouvez extraire la valeur d’une cellule dans chaque raster en entrée. Une table est créée ; elle comporte des champs contenant les valeurs de cellule pour chaque raster en entrée.
Les attributs supplémentaires provenant de la table raster en entrée, s’ils existent, ne seront pas transférés vers la table en sortie.
Lorsqu’un raster multicanal est spécifié comme l’un des rasters en entrée (Input Rasters) (in_rasters dans Python), tous les canaux de cette entrée sont utilisés.
Pour traiter une sélection de canaux à partir d’un raster multicanal en entrée, créez d’abord un jeu de données raster composé de ces canaux spécifiques à l’aide de l’outil Canaux composites. Utilisez le résultat dans la liste des rasters en entrée.
Lorsqu’un raster multidimensionnel est spécifié comme raster en entrée, si l’option Process as multidimensional (Traiter en tant que multidimensionne) (ALL_SLICES pour le paramètre process_as_multidimensional dans Python) n’est pas activée, seule la tranche actuelle du raster multidimensionnel sera échantillonnée.
Pour extraire les valeurs des tranches de toutes les variables du jeu de données multidimensionnelles en entrée, cochez l’option Process as multidimensional (Traiter en tant que multidimensionnel).
Les types de raster multidimensionnel actuellement pris en charge par cet outil dans le cadre du traitement multidimensionnel sont les couches raster netCDF et les jeux de données mosaïque multidimensionnels. Les services d’imagerie des données multidimensionnelles ne sont, pour l’heure, pas pris en charge.
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.
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.
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.
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.
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ètre | Explication | Type 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.
| 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.
| 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