Extraction de valeurs vers des points (Spatial Analyst)
Récapitulatif
Extrait les valeurs de la cellule d'un raster selon un ensemble d'entités ponctuelles et enregistre les valeurs dans la table attributaire d'une classe d'entités en sortie.
Utilisation
Tous les champs de la classe d'entités points en entrée seront compris dans la classe d'entités points en sortie.
-
Un nouveau champ est ajouté à la classe d'entités en sortie, nommé RASTERVALU.
Remarque :Ce champ ne peut pas déjà exister dans la table attributaire des entités en entrée. S'il existe déjà, une erreur surviendra. Si vous souhaitez conserver les informations d'origine, avant d'effectuer l'extraction de valeurs vers des points, vous pouvez ajouter un nouveau champ (par exemple, RASVAL1) dans la table attributaire, calculer ses valeurs, puis supprimer le champ RASTERVALUE d'origine.
-
Lorsque vous utilisez l'extraction de valeurs vers des points sur un raster multicanal, le champ RASTERVALU contient les valeurs du dernier canal du raster en entrée. Pour extraire des valeurs de plusieurs rasters ou d'un jeu de données de rasters multicanaux, utilisez l'outil Extraction de valeurs multiples vers des points.
-
Dans le cas du champ RASTERVALU de la table attributaire, les cellules NoData dans le raster de valeurs se voient attribuer la valeur -9999.
-
L'option d'interpolation détermine la façon dont les valeurs sont récupérées du raster. L'option par défaut est d'utiliser la valeur qui se trouve au centre de la cellule en cours d'échantillonnage. L'option d'interpolation utilise l'interpolation bilinéaire pour interpoler la valeur du centre de la cellule.
-
Si le raster en entrée est du type virgule flottante, le jeu de données de points en sortie résultant contiendra seulement des attributs des données d'entité en entrée et la valeur de la cellule, comme indiqué via l'option d'interpolation.
-
Lors de l'ajout des attributs du raster en entrée, si le jeu de données d'entité de points en sortie est un fichier de formes, il ne peut pas y avoir de champs dans le raster en entrée avec un nom de plus de 10 caractères. S'ils existent, vous devez renommer ces champs avant d'utiliser l'outil.
Syntaxe
| Paramètre | Explication | Type de données |
in_point_features |
Les entités de points en entrée qui désignent les emplacements à partir desquels vous souhaitez extraire des valeurs de cellules de raster. | Feature Layer |
in_raster |
Jeu de données du raster dont les valeurs seront extraites. Il peut s'agir d'un entier ou d'un raster de type virgule flottante. | Raster Layer |
out_point_features |
Jeu de données d'entité de points en sortie contenant les valeurs extraites du raster. | Feature Class |
interpolate_values (Facultatif) |
Spécifie si l'interpolation sera ou non utilisée.
| Boolean |
add_attributes (Facultatif) |
Indique si les attributs du raster sont écrits dans le jeu de données d'entité de points en sortie.
| Boolean |
Exemple de code
Dans cet exemple, on extrait les valeurs de la cellule d'un raster selon les emplacements définis par un fichier de formes ponctuelles, puis on crée une classe d'entités points en sortie de ces valeurs.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
ExtractValuesToPoints("rec_sites.shp", "elevation",
"C:/sapyexamples/output/outValPnts","INTERPOLATE",
"VALUE_ONLY")
Dans cet exemple, on extrait les valeurs de la cellule d'un raster selon les emplacements définis par un fichier de formes ponctuelles, puis on crée un fichier de formes en sortie correspondant à ces valeurs.
# Name: ExtractValuesToPoints_Ex_02.py
# Description: Extracts the cells of a raster based on 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
inPointFeatures = "rec_sites.shp"
inRaster = "elevation"
outPointFeatures = "C:/sapyexamples/output/extractvaluespts.shp"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
"INTERPOLATE", "VALUE_ONLY")