Extraction de valeurs vers des points (Outils Spatial Analyst)

Résumé

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.

L’outil Extract Multi Values to Point (Extraction de valeurs multiples vers des points) offre des fonctions ou des performances améliorées.

Utilisation

Tous les champs de la classe d’entités ponctuelles en entrée sont reportés dans la classe d’entités ponctuelles en sortie.
Un nouveau champ nommé RASTERVALU est ajouté à la sortie pour stocker les valeurs extraites. Si un champ portant ce nom existe déjà dans la table attributaire des entités en entrée, l’exécution de l’outil échoue.
Le raster en entrée n’est pas rééchantillonné pour respecter l’environnement d’analyse. À la place, les valeurs de cellule sont extraites du raster en entrée dans ses résolution et référence spatiale d’origine en projetant les localisations en entrée dans la référence spatiale du raster d’où les valeurs sont extraites.

Toutefois, l’environnement d’analyse est appliqué aux localisations en entrée.
Les localisations qui extraient les valeurs des cellules NoData dans le raster en entrée ont la valeur <nulle> dans la table en sortie. Pour les shapefiles, étant donné que les champs Null ne sont pas pris en charge, des cellules NoData sont représentées à la place dans la table avec la valeur -9999.
Le format shapefile limite la longueur des noms de champ à 10 caractères. Par conséquent, le nom de tout champ ajouté à la table attributaire d’un shapefile en sortie est tronqué et rendu unique par défaut. Il peut donc être difficile de distinguer les champs les uns des autres, notamment si leurs noms sont longs ou très similaires. Dans ce cas, il est conseillé de diriger la sortie vers une géodatabase fichier.
L’exécution de l’outil avec des entités multi-points échoue. Pour effectuer une analyse avec des entités multi-points, convertissez ces dernières 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.
Lorsqu’un raster multibande est spécifié comme valeur Input Raster (Raster en entrée) (in_raster dans Python), seul la première bande est utilisée.

Pour traiter un autre canal, spécifiez-le.

Pour extraire des valeurs de plusieurs rasters ou d’un jeu de données raster multibande, utilisez l’outil Extract Multi Values To Points (Extraction de valeurs multiples vers des points).
L'option d'interpolation détermine comment les valeurs seront obtenues à partir du raster. L’option par défaut consiste à extraire la valeur de cellule exacte aux emplacements en entrée. Pour extraire une valeur interpolée à l’aide d’une méthode bilinéaire, activez l’option Interpolate values at the point locations (Interpoler les valeurs aux localisations des points) (interpolate_values dans Python).
Pour ajouter tous les attributs de la table raster en entrée, activez l’option Append all the input raster attributes to the output point features (Ajouter tous les attributs du raster en entrée aux entités ponctuelles en sortie) (ALL pour le paramètre add_attributes dans Python). Les attributs sont reportés tels quels dans les entités ponctuelles en sortie, en conservant les mêmes valeurs. Notez que, selon la nature de la propriété en cours d’enregistrement, il peut être nécessaire de recalculer certaines valeurs attributaires.
Si l’environnement Output Coordinate System (Système de coordonnées en sortie) n’a pas été explicitement spécifié, la référence spatiale de la classe d’entités en sortie est dérivée des entités ponctuelles en entrée. Toutefois, si la sortie est écrite dans un jeu de classes d’entités, avec ou sans environnement Output Coordinate System (Système de coordonnées en sortie) spécifié, la référence spatiale en sortie est la même que celle du jeu de classes d’entités.
Si une entité est spécifiée dans l’environnement Mask (Masque), elle est convertie en raster en interne en utilisant la taille de cellule et l’alignement de cellule du raster en entrée.
Reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil.

Etiqueter	Explication	Type de données
Entités points en entrée	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
Raster en entrée	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
Entités points en sortie	Jeu de données d'entité de points en sortie contenant les valeurs extraites du raster.	Feature Class
Interpoler les valeurs aux emplacements des points (Facultatif)	Spécifie si l’interpolation sera utilisée. Activé—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. Décoché—AUCUN : aucune interpolation ne sera appliquée et la valeur du centre de la cellule sera utilisée. Il s’agit de l’option par défaut.	Boolean
Ajouter tous les attributs du raster en entrée aux entités ponctuelles en sortie (Facultatif)	Indique si les attributs du raster sont écrits dans le jeu de données d'entité de points en sortie. Activé—Tous les champs du raster en entrée (hormis `Count`) sont ajoutés aux attributs de points. Décoché—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.	Boolean

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

Nom	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 utilisée. `INTERPOLATE`—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. `NONE`—AUCUN : aucune interpolation ne sera appliquée et la valeur du centre de la cellule sera utilisée. Il s’agit de l’option par défaut.	Boolean
add_attributes (Facultatif)	Indique si les attributs du raster sont écrits dans le jeu de données d'entité de points en sortie. `ALL`—Tous les champs du raster en entrée (hormis `Count`) sont ajoutés aux attributs de points. `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.	Boolean

Exemple de code

ExtractValuesToPoints Exemple 1 (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")

ExtractValuesToPoints Exemple 2 (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"

# Run ExtractValuesToPoints
ExtractValuesToPoints(inPointFeatures, inRaster, outPointFeatures,
                      "INTERPOLATE", "VALUE_ONLY")

Environnements

Validation automatique, Espace de travail courant, Valeur Z en sortie par défaut, Etendue, Transformations géographiques, Masque, Résolution M, Tolérance M, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Valeurs M en sortie, Valeurs Z en sortie, Domaine M en sortie, Domaine XY en sortie, Domaine Z en sortie, Gérer les noms de champs complets, Espace de travail temporaire, Transférer les descriptions des domaines de champs, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z

Informations de licence