Extraction de valeurs multiples vers des points (Spatial Analyst)

Synthèse

Extrait des valeurs d'une cellule aux emplacements spécifiés dans une classe d'entités points d'un ou de plusieurs rasters et enregistre les valeurs dans la table attributaire de la classe d'entités points.

Utilisation

  • Cet outil modifie les entités ponctuelles en entrée et peut modifier l’ID interne des entités, qui peut être ObjectID, FID ou OID. Il est conseillé d’inclure un champ d’ID unique dans la table attributaire avant de procéder à l’analyse.

  • Les valeurs de cellule seront extraites de tous les rasters en entrée à chaque emplacement. Un nouveau champ contenant les valeurs de cellule de chaque raster en entrée est ajouté dans la classe d’entités ponctuelles en entrée.

  • Les éventuels attributs supplémentaires de la table raster en entrée ne sont pas ajoutés aux entités ponctuelles en entrée.

  • Les rasters en entrée ne sont pas rééchantillonnés pour respecter l’environnement d’analyse. À la place, les valeurs de cellule sont extraites de tous les rasters en entrée dans leur résolution et leur 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 <null> 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 entrée 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 recommandé de copier le shapefile en entrée dans une géodatabase fichier et d’utiliser la classe d’entités pour l’analyse.

  • Si les valeurs Input point features (Entités ponctuelles en entrée) (in_point_features en Python) dont définies à l’aide d’une couche d’événements XY, la table d’événements sous-jacente est mise à jour directement. L’outil échoue si la table sous-jacente est en lecture seule.

  • Si la valeur Input point features (Entités ponctuelles en entrée) est une classe d’entités ponctuelles sans index spatial, un avertissement est émis. Pour améliorer les performances de l’outil d’une entrée comportant un nombre élevé de points, créez un index spatial. Pour plus d’informations, reportez-vous à la rubrique relative à l’outil Ajouter un index spatial.

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

  • Vous pouvez définir n’importe quelle combinaison de rasters (monocanal ou multicanal) pour le paramètre Input rasters (Rasters en entrée) (in_rasters en Python).

  • Lorsqu’un raster multicanal est spécifié comme l’une des valeurs dans le champ Input Rasters (Rasters en entrée) (in_rasters dans Python), tous les canaux de cette entrée sont utilisés.

    Pour traiter une sélection de canaux d’un raster multicanal, créez d’abord un jeu de données raster composé de ces canaux spécifiques à l’aide de l’outil Canaux composites. Ensuite, utilisez le résultat dans la liste des rasters en entrée.

  • Lorsque l’entrée est un raster multicanal, un champ est ajouté pour tous les canaux. Le préfixe b1_, b2_, …bn est ajouté au nom du champ en sortie pour indiquer le numéro de canal.

  • Les noms de champ en sortie sont créés par défaut à partir du nom du raster en entrée. Sinon, vous pouvez attribuer un nom distinct à chaque champ pour stocker des valeurs de raster.

  • Le paramètre Bilinear interpolation of values at point locations (Interpolation bilinéaire des valeurs aux emplacements des points) (bilinear_interpolate_values en Python) spécifie si l’interpolation est utilisée pour obtenir les valeurs du raster. L’option par défaut consiste à extraire la valeur de cellule exacte aux emplacements en entrée. Pour extraire des valeurs interpolées à l’aide de la méthode bilinéaire, activez ce paramètre (bilinear_interpolate_values = "BILINEAR" en Python).

  • Si une entité est spécifiée dans l’environnement Mask (Masque), un raster interne est créé avec la taille de cellule minimale des rasters en entrée. Lors de l’extraction, le raster de masque interne est à nouveau rééchantillonné sur la taille de cellule de chaque 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.

Paramètres

ÉtiquetteExplicationType de données
Entités points en entrée

Entités ponctuelles en entrée auxquelles des valeurs de raster doivent être ajoutées.

Feature Layer
Rasters en entrée

Valeurs de raster(s) en entrée à extraire selon l’emplacement des entités ponctuelles en entrée.

Le cas échéant, vous pouvez indiquer le nom du champ pour stocker la valeur de raster. Par défaut, vous créez un nom de champ distinct d'après le nom du jeu de données du raster en entrée.

Extract Values
Interpolation bilinéaire des valeurs aux emplacements des points
(Facultatif)

Spécifie si l’interpolation sera utilisée.

  • Décoché : aucune interpolation n'est appliquée et la valeur du centre de la cellule est utilisée. Il s’agit de l’option par défaut.
  • Coché : 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

Sortie obtenue

ÉtiquetteExplicationType de données
Entités ponctuelles mises à jour

Entités ponctuelles mises à jour.

Feature Class

ExtractMultiValuesToPoints(in_point_features, in_rasters, {bilinear_interpolate_values})
NomExplicationType de données
in_point_features

Entités ponctuelles en entrée auxquelles des valeurs de raster doivent être ajoutées.

Feature Layer
in_rasters
[Raster, {Output Field Name}]

Valeurs de raster(s) en entrée à extraire selon l’emplacement des entités ponctuelles en entrée.

Le cas échéant, vous pouvez indiquer le nom du champ pour stocker la valeur de raster. Par défaut, vous créez un nom de champ distinct d'après le nom du jeu de données du raster en entrée.

Extract Values
bilinear_interpolate_values
(Facultatif)

Spécifie si l’interpolation sera utilisée.

  • NONEAUCUN : 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.
  • BILINEARLa 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

Sortie obtenue

NomExplicationType de données
out_point_features

Entités ponctuelles mises à jour.

Feature Class

Exemple de code

Premier exemple d'utilisation de l'outil ExtractMultiValuesToPoints (fenêtre Python)

Vous pouvez extraire les valeurs de cellule de plusieurs rasters en tenant compte des attributs dans une classe d'entités ponctuelles.

import arcpy
from arcpy.sa import *
from arcpy import env 
env.workspace = "c:/sapyexamples/data"
ExtractMultiValuesToPoints("observers.shp", [["elevation", "ELEV"], 
                           ["costraster", "COST"], ["flowdir", "DIR"]], "NONE")
Deuxième exemple d'utilisation de l'outil ExtractMultiValuesToPoints (script autonome)

Vous devez extraire, via une interpolation, les valeurs de cellule dans plusieurs rasters en tenant compte des attributs d'une classe d'entités ponctuelles.

# Name: ExtractMultiValuesToPoints_Ex_02.py
# Description: Extracts the cells of multiple rasters as attributes in
#    an output point feature class.  This example takes a multiband IMG
#    and two GRID files as input.
# 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 = "poi.shp"
inRasterList = [["doqq.img", "doqqval"], ["redstd", "focalstd"], 
                ["redmin", "focalmin"]]

# Execute ExtractValuesToPoints
ExtractMultiValuesToPoints(inPointFeatures, inRasterList, "BILINEAR")

Rubriques connexes