Extraction de valeurs vers des points

Disponible avec une licence 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.

Utilisation

• Tous les champs de la classe d'entités ponctuelles en entrée seront transféré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’outil ne pourra pas être exécuté.

• Le raster en entrée ne sera pas ré-échantillonné conformément à l’environnement d’analyse. Au lieu de cela, les valeurs de cellule sont extraites du raster en entrée selon la résolution et référence spatiale d’origine en projetant les emplacements 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.

• Le format du fichier de formes limite la longueur maximale d’un nom de champ à 10 caractères. Par conséquent, le nom de tout champ ajouté à la table attributaire d’un fichier de formes en sortie sera tronqué et unique par défaut. Ceci peut compliquer l’identification des champs, si les noms sont longs ou quasi-identiques. Dans ce cas, il est préférable de générer la sortie dans une géodatabase fichier.

• 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.

• Lorsqu’un raster multicanal est spécifié en tant que Input raster (Raster en entrée) (in_raster dans Python), seul le premier canal est utilisé.

  Pour traiter un canal différent, spécifiez le canal à utiliser.

  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.

• 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 la valeur interpolée à l’aide de la méthode bilinéaire, reportez-vous à l’option Interpolate values at the point locations (Interpoler les valeurs aux emplacements des points) (interpolate_values dans Python).

• Pour ajouter tous les attributs à partir de la table raster en entrée, consultez 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 seront transférés tels quels vers les entités ponctuelles en sortie, en conservant les mêmes valeurs. Notez que selon la nature de la propriété qui est enregistrée, il est possible que certaines valeurs attributaires doivent être recalculées.

• Si l’environnement Output Coordinate System (Système de coordonnées en sortie) n’a pas été spécifié explicitement, la référence spatiale de la classe d’entités en sortie est dérivée des entités ponctuelles en entrée. Cependant, si la sortie est enregistrée dans un jeu de classes d'entités, que l’environnement Output Coordinate System (Système de coordonnées en sortie) soit spécifié ou non, la référence spatiale en sortie sera identique à celle du jeu de classes d'entités.

• Si une entité est spécifiée dans l’environnement Mask (Masque), elle sera convertie au préalable en raster en interne, à l’aide de la taille de cellule et de l’alignement de cellule du 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

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. Il s’agit de l’option par défaut. 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.	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 —Tous les champs du raster en entrée (à l'exception du champ Count) 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

• Validation automatique
• Espace de travail courant
• Valeur Z en sortie par défaut
• Etendue
• Transformations géographiques
• Masque
• Résolution M
• Tolérance M
• Conserver un index spatial
• Mot-clé de configuration 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
• Noms de champ qualifiés
• 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

• Basic: Requiert Spatial Analyst
• Standard: Requiert Spatial Analyst
• Advanced: Requiert Spatial Analyst