ArcMap

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 vers la classe d’entités ponctuelles en sortie.

  • Un nouveau champ est ajouté à la classe d'entités en sortie, nommé RASTERVALU.

  • Pour ajouter des attributs à partir de la table en entrée, cochez 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 transférés tel quel vers les entités ponctuelles en sortie en préservant les valeurs. Selon la nature de la propriété en cours d’enregistrement, vous serez amené à recalculer la valeur de certains attributs.

  • Le format de shapefile comporte une limitation en termes de longueur maximale du nom de champ de l’ordre de 10 caractères. Ainsi, les noms des champs ajoutés à la table attributaire d’un shapefile en sortie sont tronqués et sont uniques par défaut. Vous aurez donc probablement des difficultés à distinguer les champs, notamment si les noms sont longs ou quasi-identiques. Dans ce cas, il est préférable de produire un géodatabase fichier en sortie.

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

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

    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.

  • Les localisations qui échantillonnent les cellules NoData dans le raster en entrée ont la valeur <null> dans une table de géodatabase en sortie. Pour une sortie vers des fichiers de formes, comme le concept de valeur Null n'est pas pris en charge, la valeur -9999 est attribuée.

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

  • Les jeux de données multipoints ne sont pas pris en charge 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ètreExplicationType 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 (hormis 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

Informations de licence

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

Rubriques connexes