Extract by Points (Spatial Analyst)

Zusammenfassung

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

Verwendung

• Zellenpositionen, die nicht ausgewählt wurden, wird der Wert "NoData" zugewiesen.

• Wenn ein Multiband-Raster als Eingabe angegeben wird, wird als Ausgabe ein neues Multiband-Raster erstellt. Jedes Band im Eingabe-Multiband-Raster wird entsprechend analysiert.

  Das Standardausgabeformat ist ein Esri Grid Stack. Beachten Sie, dass der Name eines Esri Grid Stack nicht mit einer Zahl beginnen, keine Leerzeichen enthalten und nicht mehr als 9 Zeichen aufweisen darf.

• Wenn die Eingabe ein Layer ist, der aus einem Multiband-Raster mit mehr als drei Bändern erstellt wurde, berücksichtigt der Extraktionsvorgang nur die vom Layer geladenen (symbolisierten) Bänder. Das Ausgabe-Multiband-Raster kann demnach nur drei Bänder aufweisen, die den Bändern in der Anzeige des Eingabe-Layers entsprechen.

• Bei einem ganzzahligen Eingabe-Raster ist auch das Ausgabe-Raster ganzzahlig. Wenn die Eingaben Gleitkommawerte sind, ist die Ausgabe ebenfalls ein Gleitkommawert.

Syntax

ExtractByPoints (in_raster, points, {extraction_area})

Parameter	Erläuterung	Datentyp
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

Name	Erläuterung	Datentyp
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

Cell Size, Current Workspace, Mask, Output Coordinate System, Extent, Scratch Workspace, Snap Raster

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Erfordert Spatial Analyst

ArcGIS for Desktop Standard: Erfordert Spatial Analyst

ArcGIS for Desktop Advanced: Erfordert Spatial Analyst