Extraction par points (Outils Spatial Analyst)

Résumé

Extrait les cellules d’un raster selon un ensemble de points de coordonnées.

Héritage :

Cet outil est obsolète et sera retiré dans une version ultérieure.

L’outil Extract by Mask (Extraction par masque) offre des fonctions ou des performances améliorées.

Illustration

Utilisation

Les éventuels attributs supplémentaires du raster en entrée seront inclus tels quels dans la table attributaire du raster en sortie. Selon la propriété en cours d’enregistrement, il peut être nécessaire de recalculer certaines valeurs attributaires.
Lorsqu’un raster multibande est spécifié comme valeur dans le champ Input Raster (Raster en entrée) (in_raster dans Python), toutes les bandes sont utilisées.

Pour traiter une sélection de bandes d’un raster multibande, créez d’abord un jeu de données raster composé de ces bandes spécifiques à l’aide de l’outil Composite Bands (Bandes composites). Ensuite, utilisez le résultat comme valeur dans le champ Input Raster (Raster en entrée) (in_raster dans Python).

Le format en sortie par défaut est un raster de géodatabase. Si le format en sortie est une pile de grilles Esri, le nom de la pile ne peut pas commencer par un chiffre, contenir des espaces ni comporter plus de neuf caractères.
Les localisations de cellules non sélectionnées se voient attribuer une valeur NoData.
Si le raster en entrée est un nombre entier, le raster en sortie sera un nombre entier. Si l’entrée est un nombre à virgule flottante, la sortie est un nombre à virgule flottante.
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
Raster en entrée	Raster en entrée à partir duquel les cellules seront extraites.	Raster Layer
Points en entrée	Points où les valeurs seront extraites du raster. Les points sont spécifiées en paires de coordonnées x,y dans les mêmes unités de carte que le raster en entrée.	Point
Zone d'extraction (Facultatif)	Indique s'il faut extraire des cellules selon les emplacements des points spécifiés (à l'intérieur) ou à l'extérieur des emplacements des points (à l'extérieur). Intérieur—La cellule contenant le point sélectionné sera écrite dans le raster en sortie. Toutes les cellules situées à l'extérieur du cadre adopteront la valeur NoData sur le raster en sortie. Extérieur—Les cellules situées à l’extérieur des points en entrée doivent être sélectionnées et écrites dans le raster en sortie.	String

Etiqueter

Explication

Type de données

Raster en entrée

Raster en entrée à partir duquel les cellules seront extraites.

Raster Layer

Points en entrée

Points où les valeurs seront extraites du raster.

Les points sont spécifiées en paires de coordonnées x,y dans les mêmes unités de carte que le raster en entrée.

Point

Zone d'extraction

(Facultatif)

Indique s'il faut extraire des cellules selon les emplacements des points spécifiés (à l'intérieur) ou à l'extérieur des emplacements des points (à l'extérieur).

Intérieur—La cellule contenant le point sélectionné sera écrite dans le raster en sortie. Toutes les cellules situées à l'extérieur du cadre adopteront la valeur NoData sur le raster en sortie.
Extérieur—Les cellules situées à l’extérieur des points en entrée doivent être sélectionnées et écrites dans le raster en sortie.

String

Valeur de retour

Etiqueter	Explication	Type de données
Raster en sortie	Raster en sortie contenant les valeurs de cellule extraites du raster en entrée.	Raster

ExtractByPoints(in_raster, points, {extraction_area})

Nom Explication Type de données

Nom	Explication	Type de données
in_raster	Raster en entrée à partir duquel les cellules seront extraites.	Raster Layer
points [point,...]	Une liste Python de classes d’objets `Point` représente les localisations où les valeurs sont extraites du raster. Les objets ponctuels sont spécifiées au sein d'une liste de paires de coordonnées x,y dans les mêmes unités de carte que le raster en entrée. L'objet a la forme suivante : `[point(x1,y1), point(x2,y2),...]`	Point
extraction_area (Facultatif)	Indique s'il faut extraire des cellules selon les emplacements des points spécifiés (à l'intérieur) ou à l'extérieur des emplacements des points (à l'extérieur). `INSIDE`—La cellule contenant le point sélectionné sera écrite dans le raster en sortie. Toutes les cellules situées à l'extérieur du cadre adopteront la valeur NoData sur le raster en sortie. `OUTSIDE`—Les cellules situées à l’extérieur des points en entrée doivent être sélectionnées et écrites dans le raster en sortie.	String

in_raster

Raster en entrée à partir duquel les cellules seront extraites.

Raster Layer

points [point,...]

Une liste Python de classes d’objets Point représente les localisations où les valeurs sont extraites du raster.

Les objets ponctuels sont spécifiées au sein d'une liste de paires de coordonnées x,y dans les mêmes unités de carte que le raster en entrée.

L'objet a la forme suivante :

[point(x1,y1), point(x2,y2),...]

Point

extraction_area

(Facultatif)

Indique s'il faut extraire des cellules selon les emplacements des points spécifiés (à l'intérieur) ou à l'extérieur des emplacements des points (à l'extérieur).

INSIDE—La cellule contenant le point sélectionné sera écrite dans le raster en sortie. Toutes les cellules situées à l'extérieur du cadre adopteront la valeur NoData sur le raster en sortie.
OUTSIDE—Les cellules situées à l’extérieur des points en entrée doivent être sélectionnées et écrites dans le raster en sortie.

String

Valeur de retour

Nom	Explication	Type de données
out_raster	Raster en sortie contenant les valeurs de cellule extraites du raster en entrée.	Raster

Exemple de code

ExtractByPoints Exemple 1 (fenêtre Python)

Cet exemple décrit l'extraction des cellules d'un raster selon les coordonnées de points spécifiées.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
pointList = [arcpy.Point(743050, 4321275), arcpy.Point(743100, 4321200),
             arcpy.Point(734500,4322000)]
outPointExtract = ExtractByPoints("soil", pointList,"INSIDE")
outPointExtract.save("c:/sapyexamples/output/pntextract")

ExtractByPoints Exemple 2 (script autonome)

Cet exemple décrit l'extraction des cellules d'un raster selon les coordonnées de points spécifiées.

# Name: ExtractByPoints_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
inRaster = "soil"
pointList = [arcpy.Point(743050, 4321275),
             arcpy.Point(743100, 4321200),
             arcpy.Point(743500, 4322000),
             arcpy.Point(742900, 4321800)]

# Run ExtractByPoints
outPointExtract = ExtractByPoints("soil", pointList,"INSIDE")

# Save the output
outPointExtract.save("c:/sapyexamples/output/pntext")

Environnements

Validation automatique, Taille de cellule, Cell Size Projection Method (Méthode de projection de la taille de cellule), Compression, Espace de travail courant, Etendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence

Basic: Nécessite Spatial Analyst
Standard: Nécessite Spatial Analyst
Advanced: Nécessite Spatial Analyst

Extraction par points (Outils Spatial Analyst)

Résumé

Héritage :

Illustration

Utilisation

Paramètres

Valeur de retour

Environnements

Informations de licence

Rubriques connexes