Mit Rechteck extrahieren (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Extrahiert die Zellen eines Rasters basierend auf einem Rechteck durch Festlegung der Ausdehnung des Rechtecks.

Abbildung

Abbildung: Werkzeug "Mit Rechteck extrahieren"
OutRas = ExtractByRectangle(InRas1, Extent(1, 0, 5, 5), "INSIDE")

Verwendung

  • Zusätzliche Attribute aus dem Eingabe-Raster, sofern vorhanden, werden unverändert in die Attributtabelle des Ausgabe-Rasters übernommen. Je nach Eigenschaft, die erfasst wird, müssen einige der Attributwerte möglicherweise neu berechnet werden.

  • Wenn ein Multiband-Raster als Eingabe-Raster-Wert (in_raster in Python) angegeben wird, werden alle Bänder verwendet.

    Wenn eine Auswahl von Bändern aus einem Multiband-Raster verarbeitet werden soll, erstellen Sie zunächst mit dem Werkzeug Bänder zusammensetzen ein Raster-Dataset, das aus den betreffenden Bändern besteht. Verwenden Sie dann das Ergebnis als Eingabe-Raster-Wert (in_raster in Python).

    Das Standardausgabeformat ist ein Geodatabase-Raster. Wenn ein Esri Grid Stack als Ausgabeformat angegeben wurde, beachten Sie, dass der Stack-Name nicht mit einer Zahl beginnen, keine Leerzeichen enthalten und nicht mehr als 9 Zeichen aufweisen darf.

  • Der Mittelpunkt der Zelle wird verwendet, um zu bestimmen, ob eine Zelle innerhalb oder außerhalb eines Rechtecks liegt. Wenn sich der Mittelpunkt innerhalb der Umrisslinie des Rechtecks befindet, gilt die Zelle als vollständig innerhalb, auch wenn Teile der Zelle außerhalb des Rechtecks liegen.

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

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

  • Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Eingabe-Raster, aus dem Zellen extrahiert werden.

Raster Layer
Ausdehnung

Ein Rechteck, das den zu extrahierenden Bereich definiert.

  • Aktuelle Anzeigeausdehnung Kartenansicht: Die Ausdehnung basiert auf der aktiven Karte oder Szene. Diese Option ist nur verfügbar, wenn eine aktive Karte vorhanden ist.
  • Ausdehnung darstellen Ausgleichen und Beenden: Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Bei dieser Option wird eine Feature-Class in der Projekt-Geodatabase erstellt und ein Layer zur Karte hinzugefügt. Das Koordinatensystem der Feature-Class stimmt mit dem der Karte überein.
    Hinweis:

    Diese Option ist im Dialogfeld Umgebungen nicht verfügbar. Sie ist nur über einen Werkzeugparameter mit dem Datentyp "Ausdehnung" oder über die Registerkarte Umgebungen eines Werkzeugdialogfeldes verfügbar.

    Hinweis:

    Wenn die Bearbeitungsoption Bearbeitung über die Registerkarte "Bearbeiten" aktivieren und deaktivieren aktiviert ist, dann müssen Sie auf der Registerkarte Bearbeiten des Menübands die Bearbeitung aktivieren, um die Ausdehnung darzustellen.

  • Ausdehnung eines Layers:Layer Die Ausdehnung basiert auf einem aktiven Karten-Layer. Verwenden Sie die Dropdown-Liste, um einen verfügbaren Layer auszuwählen, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern, um die kombinierte Ausdehnung aller aktiven Karten-Layer mit Ausnahme der Grundkarte zu erhalten. Diese Option ist nur verfügbar, wenn eine aktive Karte mit Layern vorhanden ist.

    Jeder Karten-Layer bietet die folgenden Optionen:

    • Alle Features Alles auswählen: Die Ausdehnung aller Features im Layer.
    • Ausgewählte FeaturesBereich aus ausgewählten Features: Die Ausdehnung der ausgewählten Features im Layer.
    • Sichtbare Features Extent Indicator: Die Ausdehnung der sichtbaren Features im Layer.
      Hinweis:

      Die Ausdehnungen der Optionen Ausgewählte Features Bereich aus ausgewählten Features und Sichtbare Features Extent Indicator sind nur für Feature-Layer verfügbar.

  • Durchsuchen:Durchsuchen Die Ausdehnung basiert auf einem vorhandenen Dataset.
  • Zwischenablage Einfügen: Die Ausdehnung kann in die Zwischenablage kopiert und aus der Zwischenablage eingefügt werden.
    • Ausdehnung kopieren Kopieren: Kopiert die Ausdehnungskoordinaten und das Ausdehnungskoordinatensystem in die Zwischenablage.
    • Ausdehnung einfügen Einfügen: Fügt die Ausdehnungskoordinaten und optional das Koordinatensystem aus der Zwischenablage ein. Wenn die Werte in der Zwischenablage kein Koordinatensystem beinhalten, wird für die Ausdehnung das Koordinatensystem der Karte verwendet.
    Hinweis:

    Beim Kopieren der Ausdehnungskoordinaten in die und Einfügen aus der Zwischenablage wird dieselbe Formatierung und Reihenfolge wie beim ArcPy-Objekt Extent verwendet: X-Min, Y-Min, X-Max, Y-Max und der Raumbezug.

  • Ausdehnung zurücksetzen: ZurücksetzenDie Ausdehnung wird auf den Standardwert zurückgesetzt.
  • Manuell eingegebene Koordinaten: Die Koordinaten müssen numerische Werte sein und im Koordinatensystem der aktiven Karte liegen.
    Vorsicht:

    Die Karte kann statt der eingegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Die Verwendung einer Kardinalrichtung (N, S, O, W) wird nicht unterstützt. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.

Die Koordinaten werden in den gleichen Karteneinheiten angegeben wie das Eingabe-Raster.

Extent
Zu extrahierende Fläche
(optional)

Gibt an, ob die Zellen innerhalb oder außerhalb des Eingaberechtecks ausgewählt und in das Ausgabe-Raster geschrieben werden.

  • InnerhalbZellen innerhalb des Eingaberechtecks werden ausgewählt und in das Ausgabe-Raster geschrieben. Alle Zellen außerhalb des Rechtecks erhalten NoData-Werte im Ausgabe-Raster.
  • AußerhalbZellen außerhalb des Eingaberechtecks werden ausgewählt und in das Ausgabe-Raster geschrieben. Alle Zellen innerhalb des Rechtecks erhalten NoData-Werte im Ausgabe-Raster.
String

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

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

Raster

ExtractByRectangle(in_raster, rectangle, {extraction_area})
NameErläuterungDatentyp
in_raster

Das Eingabe-Raster, aus dem Zellen extrahiert werden.

Raster Layer
rectangle
extent

Ein Rechteck, das den zu extrahierenden Bereich definiert.

  • MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet.
  • MINOF: Die minimale gemeinsame Fläche aller Eingaben wird verwendet.
  • DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige.
  • Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet.
  • Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet.
  • Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt.

Die Koordinaten werden in den gleichen Karteneinheiten angegeben wie das Eingabe-Raster.

Extent
extraction_area
(optional)

Gibt an, ob die Zellen innerhalb oder außerhalb des Eingaberechtecks ausgewählt und in das Ausgabe-Raster geschrieben werden.

  • INSIDEZellen innerhalb des Eingaberechtecks werden ausgewählt und in das Ausgabe-Raster geschrieben. Alle Zellen außerhalb des Rechtecks erhalten NoData-Werte im Ausgabe-Raster.
  • OUTSIDEZellen außerhalb des Eingaberechtecks werden ausgewählt und in das Ausgabe-Raster geschrieben. Alle Zellen innerhalb des Rechtecks 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

ExtractByRectangle – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden Zellen außerhalb einer rechteckigen Ausdehnung in ein neues Raster extrahiert.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
rectExtract = ExtractByRectangle("elevation", 
                                 Extent(477625, 213900, 486400, 224200), 
                                 "OUTSIDE")
rectExtract.save("c:/sapyexamples/output/extrect")
ExtractByRectangle – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden Zellen innerhalb einer rechteckigen Ausdehnung in ein neues Raster extrahiert.

# Name: ExtractByRectangle_Ex_02.py
# Description: 
# 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 = "elevation"
inRectangle = Extent(477625, 213900, 486400, 224200)

# Execute ExtractByRectangle
rectExtract = ExtractByRectangle(inRaster, inRectangle, "INSIDE")

# Save the output 
rectExtract.save("c:/sapyexamples/output/extrect02")

Lizenzinformationen

  • Basic: Erfordert Spatial Analyst
  • Standard: Erfordert Spatial Analyst
  • Advanced: Erfordert Spatial Analyst

Verwandte Themen