Extract by Polygon (Spatial Analyst)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Extrahiert die Zellen eines Rasters auf Basis eines Polygons.

Verwendung

Syntax

ExtractByPolygon (in_raster, polygon, {extraction_area})
ParameterErläuterungDatentyp
in_raster

Das Eingabe-Raster, aus dem Zellen extrahiert werden.

Raster Layer
polygon
[point,...]

Ein Polygon (oder Polygone), das den Bereich des Eingabe-Rasters definiert, der extrahiert werden soll.

Jeder Polygonteil ist eine Liste von Stützpunkten, die durch Point-Klassen definiert sind. Optional kann eine Polygon-Klasse verwendet werden, um eine Liste von Polygonteilen zu definieren.

Die Punkte werden als XY-Koordinatenpaare angegeben. Das Objekt hat folgendes Format:

  • [[point(x1,y1), point(x2,y2),point(xn,yn),...point(x1,y1)], [point(x'1,y'1), point(x'2,y'2),point(x'n,y'n),...,point(x'1,y'1)]

Beachten Sie, dass die letzte Koordinate mit der ersten identisch sein sollte, um das Polygon zu schließen.

Point
extraction_area
(optional)

Gibt an, ob Zellen innerhalb oder außerhalb des Eingabepolygons extrahiert werden sollen.

  • INSIDE Ein Schlüsselwort, das angibt, dass die Zellen innerhalb des Eingabepolygons ausgewählt und in das Ausgabe-Raster geschrieben werden sollen. Alle Zellen außerhalb des Polygons erhalten NoData-Werte im Ausgabe-Raster.
  • OUTSIDE Ein Schlüsselwort, das angibt, dass die Zellen außerhalb des Eingabepolygons ausgewählt und in das Ausgabe-Raster geschrieben werden sollen. Alle Zellen innerhalb des Polygons erhalten NoData-Werte im Ausgabe-Raster.
String

Rückgabewert

NameErläuterungDatentyp
out_raster

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

Raster

Codebeispiel

ExtractByPolygon – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden Zellen auf Grundlage der definierten Polygonkoordinaten aus einem Raster extrahiert.

import arcpy
from arcpy import env
from arcpy.sa import *
polyPoints = [arcpy.Point(743050, 4321275), arcpy.Point(743100, 4321200), 
             arcpy.Point(743500, 4322000),arcpy.Point(742900, 4321800)]
env.workspace = "C:/sapyexamples/data"
extPolygonOut = ExtractByPolygon("soil", polyPoints, "INSIDE")
extPolygonOut.save("c:/sapyexamples/output/extpoly")
ExtractByPolygon – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden Zellen auf Grundlage der definierten Polygonkoordinaten aus einem Raster extrahiert.

# Name: ExtractByPolgyon_Ex_02.py
# Description: Extracts the cells of a raster based on a polygon.
# 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"
polyPoints = [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 ExtractByPolygon
extPolygonOut = ExtractByPolygon(inRaster, polyPoints, "INSIDE")

# Save the output 
extPolygonOut.save("c:/sapyexamples/output/extpoly02")

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