Extract by Points (Spatial Analyst)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Extrahiert die Zellen eines Rasters auf Grundlage einer Reihe von Koordinatenpunkten.

Verwendung

Syntax

ExtractByPoints (in_raster, points, {extraction_area})
ParameterErläuterungDatentyp
in_raster

Das Eingabe-Raster, aus dem Zellen extrahiert werden.

Raster Layer
points
[point,...]

Eine Python-Liste von Point-Klassenobjekten bezeichnet die Positionen, an denen Werte aus dem Raster extrahiert werden.

Die Punktobjekte werden in einer Liste von XY-Koordinatenpaaren angegeben. Das Objekt hat folgendes Format:

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

Die Punkte werden in den gleichen Karteneinheiten angegeben wie in_raster.

Point
extraction_area
(optional)

Gibt an, ob Zellen auf Grundlage der angegebenen Punktpositionen (innerhalb) oder außerhalb der Punktpositionen (außerhalb) extrahiert werden sollen.

  • INSIDE Ein Schlüsselwort, das angibt, dass die Zelle, in der der ausgewählte Punkt liegt, in das Ausgabe-Raster geschrieben werden soll. Alle Zellen außerhalb des Fels erhalten NoData-Werte im Ausgabe-Raster.
  • OUTSIDE Ein Schlüsselwort, das angibt, dass die Zellen außerhalb des Eingabepunkte ausgewählt und in das Ausgabe-Raster geschrieben werden sollen.
String

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster mit den Zellenwerten, die aus dem Eingabe-Raster extrahiert wurden.

Raster

Codebeispiel

ExtractByPoints – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden Zellen auf Grundlage der angegebenen Punktkoordinaten aus einem Raster extrahiert.

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 – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden Zellen auf Grundlage der angegebenen Punktkoordinaten aus einem Raster extrahiert.

# 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)]

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

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

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

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Erfordert Spatial Analyst
ArcGIS for Desktop Standard: Erfordert Spatial Analyst
ArcGIS for Desktop Advanced: Erfordert Spatial Analyst
9/12/2013