Disponible avec une licence Spatial Analyst.
Récapitulatif
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, comme le concept de valeur <null> n'est pas pris en charge, vous obtenez la valeur 0 (zéro).
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è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 for Desktop Basic: Requis ArcGIS Spatial Analyst
- ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst
- ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst