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
Les valeurs de cellule seront extraites de tous les rasters en entrée à chaque emplacement. Une table est créée avec des champs contenant les valeurs de cellule de chaque raster en entrée.
Les éventuels attributs supplémentaires de la table raster en entrée ne seront pas inclus dans la table en sortie.
Les rasters en entrée ne seront pas ré-échantillonnés conformément à l’environnement d’analyse. Au lieu de cela, les valeurs de cellule sont extraites de tous les rasters en entrée dans leur résolution et référence spatiale d’origine selon les emplacements de projection en entrée dans la référence spatiale du raster à partir de laquelle sont extraites les valeurs.
L’environnement d'analyse est toutefois appliqué aux emplacements en entrée.
Les localisations qui extraient des valeurs des cellules NoData dans le raster en entrée se voient attribuer la valeur <null> dans la table en sortie. Les champs null n’étant pas pris en charge pour les fichiers de forme, les cellules NoData sont représentées dans la table par la valeur -9999.
Vous pouvez définir n'importe quelle combinaison de rasters (monocanal ou multicanal) en tant que Input rasters (Rasters en entrée) (in_rasters dans Python).
Lorsqu’un raster multicanal est spécifié comme l’un des Input Rasters (Rasters en entrée) (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 tout 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.
Lorsque les données d’emplacement en entrée correspondent à un raster, le centre de chaque cellule contenant des valeurs valides (différentes de NoData) est utilisé pour extraire les valeurs de cellule de tous les rasters en entrée pour cet emplacement.
Si les données d’emplacement en entrée correspondent à une classe d’entités ponctuelles et qu’elles ne possèdent pas d’index spatial, un avertissement est émis. Pour améliorer les performances de l’outil lorsque le nombre d’entités ponctuelles en entrée est important, créez un index spatial.
L’outil ne peut pas être exécuté avec les entités multi-points. Pour effectuer l’analyse avec des entités multi-points, convertissez-les au préalable en entités ponctuelles uniques avant de les utiliser dans l'outil d’extraction. Reportez-vous à la rubrique Traitement des données multi-points pour plus d'informations.
La référence spatiale des coordonnées x,y dans la table d’exemple en sortie est identique à celle du Input location raster or point features (Raster de localisation ou entités points en entrée) (in_location_data dans Python), sauf si cela est spécifié dans l’environnement Output Coordinate System (Système de coordonnées en sortie). Si la référence spatiale des données d’emplacements en entrée est inconnue, la référence spatiale des coordonnées x,y est également inconnue.
La référence spatiale des coordonnées x,y est identifiée à la fin de l’exécution de l’outil sous forme de message de géotraitement.
L’option Resampling technique (Technique de rééchantillonnage) (resampling_type dans Python) détermine la façon dont seront obtenues les valeurs à partir du raster. L’option par défaut est Nearest (Le plus proche), qui extraie la valeur de cellule exacte aux emplacements en entrée. Pour extraire des valeurs interpolées, spécifiez l’option Bilinear (Bilinéaire) ou Cubic (Cubique).
Le type de champ contenant les valeurs de cellule correspond au type de raster de l’option la plus proche. Cependant, pour conserver la précision des valeurs interpolées, le type de champ des options Bilinear (Bilinéaire) ou Cubic (Cubique) sera toujours à virgule flottante. Lorsque l’option de rééchantillonnage est définie sur Nearest (Le plus proche), le champ de la table en sortie correspond à celui du type raster. Cependant, afin de conserver la précision des valeurs interpolées, le type de champ des options Bilinear (Bilinéaire) ou Cubic (Cubique) sera toujours à virgule flottante.
Un champ nommé Sample_point est ajouté à la table en sortie pour stocker les valeurs spécifiées dans Unique ID field (Champ d'identifiant unique) (unique_id_field dans Python). Il est recommandé d’utiliser un champ contenant des valeurs uniques pour identifier chaque emplacement pour une analyse approfondie.
Lorsqu’un raster multidimensionnel est spécifié en tant que raster en entrée et que le paramètre Process as multidimensional (Traiter comme multidimensionnel) n’est pas sélectionné (ALL_SLICES pour le paramètre process_as_multidimensional dans Python), seule la tranche actuelle du raster multidimensionnel est échantillonnée.
Pour extraire les valeurs de toutes les tranches de toutes les variables du jeu de données multidimensionnelles en entrée, sélectionnez le paramètre Process as multidimensional (Traiter comme multidimensionnel).
Si le paramètre Process as multidimensional (Traiter comme multidimensionnel) est sélectionné (ALL_SLICES pour le paramètre process_as_multidimensional dans Python), l’événement suivant se produit.
L’outil ne traitera qu’un raster multidimensionnel. Si plus d’un raster multidimensionnel est spécifié, seul le premier raster sera traité.
Les valeurs extraites sont stockées dans un champ portant le même nom que la variable. Des champs supplémentaires sont créés pour stocker les valeurs de dimensions non spatiales portant le même nom que la dimension.
Si le raster multidimensionnel possède plusieurs canaux, des champs supplémentaires ne sont pas créés pour chaque canal. Au lieu de cela, les valeurs extraites pour les canaux sont stockées dans le champ de la variable. Un champ supplémentaire est créé pour la dimension ayant servi à spécifier le canal, afin de stocker les valeurs de dimension.
Les types de raster multidimensionnel actuellement pris en charge par cet outil pour le traitement multidimensionnel sont les couches raster netCDF et les jeux de données mosaïque multidimensionnelles. Les services d’imagerie des données multidimensionnelles peuvent également être utilisés à condition que la configuration du service d'imagerie le permette.
Si une entité est spécifiée dans l’environnement Mask (Masque), un raster interne est créé en utilisant la taille de cellule minimum des rasters en entrée. Lors de l’extraction, le raster de masque interne est à nouveau ré-échantillonné sur la taille de cellule de chaque raster 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
- Basic: Requiert Spatial Analyst
- Standard: Requiert Spatial Analyst
- Advanced: Requiert Spatial Analyst