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 localisations qui échantillonnent des cellules NoData dans le/les rasters en entrée se voient affecter la valeur NULL. Dans le cas d'un fichier de formes, la valeur NULL n'est pas compatible. Vous obtenez la valeur 0 (zéro).
-
Les valeurs de cellules resteront des entiers pour les rasters des raster d'entiers, même si les options Bilinéaire ou Cubique sont sélectionnées pour la méthode de rééchantillonnage.
-
La taille de cellule et l'inscription des rasters en entrée et du raster de localisation doivent identiques.
-
La sortie de l'outil est une table.
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. | 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)