Echantillon (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.
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 emplacements 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).
-
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éaire ou Cubique é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.
Syntaxe
| 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. Si aucune extension n'est spécifiée, il s'agira d'une table INFO. Si l'emplacement est dans une géodatabase, la table en sortie sera créée dans ce type particulier (par exemple, une géodatabase fichier ou ArcSDE). Si le nom possède une extension .dbf, la sortie sera au format dBASE. | Table |
resampling_type (Facultatif) |
Algorithme de rééchantillonnage utilisé lors de l'échantillonnage d'un raster.
| String |
Exemple de code
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")
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)