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

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

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

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

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

Informations de licence

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

Rubriques connexes