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 RASTERVALU 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 comment les valeurs seront obtenues à partir du raster. L'option par défaut consiste à utiliser la valeur au centre de la cellule qui est échantillonnée. L'option d'interpolation utilisera l'interpolation bilinéaire pour interpoler une valeur pour le 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.

• Les jeux de données multipoints ne sont pas pris en charge en entrée.

Syntaxe

ExtractValuesToPoints (in_point_features, in_raster, out_point_features, {interpolate_values}, {add_attributes})

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. NONE — AUCUN : aucune interpolation ne sera appliquée et la valeur du centre de la cellule sera utilisée. INTERPOLER — La valeur de la cellule est calculée à partir des cellules adjacentes avec des valeurs autorisées à l'aide de l'interpolation bilinéaire. Les valeurs NoData ne sont pas prises en compte dans l'interpolation, sauf si elles sont attribuées à toutes les cellules adjacentes.	Boolean
add_attributes (Facultatif)	Indique si les attributs du raster sont écrits dans le jeu de données d'entité de points en sortie. VALUE_ONLY — Décoché : seule la valeur du raster en entrée est ajoutée aux attributs de points. Il s'agit de l'option par défaut. ALL — ALL : tous les champs du raster en entrée (hormis Total) sont ajoutés aux attributs de points.	Boolean

Exemple de code

1er exemple d'utilisation de l'outil Extraction de valeurs vers des points (fenêtre Python)

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")

2ème exemple d'utilisation de l'outil Extraction de valeurs vers des points (script autonome)

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")

Environnements

Espace de travail courant, Mot-clé CONFIG en sortie, Domaine M en sortie, Domaine XY en sortie, Domaine Z en sortie, Système de coordonnées en sortie, Etendue, Grille spatiale 1 en sortie , Grille spatiale 2 en sortie , Grille spatiale 3 en sortie, Noms de champ qualifiés, Espace de travail temporaire, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z

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