Skip to main content

Nach Maske extrahieren (Spatial Analyst Tools)

Zusammenfassung

Extrahiert die Zellen eines Rasters, die den mit einer Maske definierten Flächen entsprechen.

Abbildung

Abbildung: Werkzeug "Nach Maske extrahieren"

OutRas = ExtractByMask(InRas1, InMsk1, "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.

  • Wenn ein Multiband-Raster für die Eingabe-Raster-Maske angegeben wird, wird nur das erste Band im Vorgang verwendet.

  • Wenn der Wert Eingabe-Raster (in_raster in Python) und die unter Eingabe-Raster oder -Feature-Masken-Daten (in_mask_data in Python) angegebenen Raster-Daten dieselbe Zellengröße aufweisen und die Zellen ausgerichtet sind, werden sie direkt im Werkzeug verwendet. Während der Werkzeugausführung erfolgt kein internes Resampling.

    Bei Abweichungen der Zellengröße entspricht die Ausgabezellengröße dem Maximum der Eingabedaten. In diesem Fall wird der Wert Eingabe-Raster intern als Fang-Raster verwendet. Wenn die Zellengröße übereinstimmt, die Zellen jedoch nicht ausgerichtet sind, wird der Wert Eingabe-Raster intern als Fang-Raster verwendet. In beiden Fällen wird ein internes Resampling ausgelöst, bevor der Extraktionsvorgang ausgeführt wird.

    Weitere Informationen finden Sie in den Themen Zellengröße und Fang-Raster zur Umgebung.

  • Ein Eingaberaster mit rechteckigen Zellen wird so verarbeitet, dass die Zellen des Ausgaberasters quadratisch sind und die Seiten gleich dem Durchschnitt der Länge und Breite des Rechtecks sind.

  • Wenn die Maskeneingabe ein Feature ist, wird sie intern in ein Raster konvertiert, wobei standardmäßig die Zellengröße und die Zellenausrichtung (Fang-Raster) aus dem Wert Eingabe-Raster verwendet werden.

  • Wenn während der Ausführung des Werkzeugs Nach Maske extrahieren in der Umgebungseinstellung Maske angegeben ist, weist das Ausgabe-Raster lediglich Zellenwerte für die Fläche auf, die im Schnittpunkt der Umgebungsmaske und der Eingabemaskendaten liegt.

  • Sie können den Parameter Analyseausdehnung (analysis_extent in Python) verwenden, um den Ausgabeanalysebereich explizit für die Ausführung eines eigenständigen Werkzeugs anzugeben oder um die Umgebungseinstellung als Teil eines Workflows außer Kraft zu setzen. Sie können die Ausdehnung angeben, indem Sie Werte eingeben, die Anzeigeausdehnung wählen, einen Layer auswählen oder nach einem Eingabe-Dataset suchen.

  • Der Standardwert Analyseausdehnung wird aus dem Schnittpunkt der Werte Eingabe-Raster und Eingabe-Raster oder -Feature-Masken-Daten berechnet.

  • Wenn die Analyseausdehnung nicht explizit als Parameterwert angegeben wird, wird sie aus den Umgebungseinstellungen für die Analyse abgeleitet.

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

Parameter

Beschriftung Erläuterung Datentyp

Eingabe-Raster

Das Eingabe-Raster, aus dem Zellen extrahiert werden.

Raster Layer

Eingabe-Raster oder -Feature-Masken-Daten

Die Eingabemaskendaten, die die zu extrahierenden Zellenpositionen definieren.

Hierbei kann es sich um ein Raster oder ein Feature-Dataset handeln.

Wenn es sich bei den Eingabemaskendaten um ein Raster handelt, werden NoData-Zellen in der Maske NoData-Werte im Ausgabe-Raster zugewiesen.

Wenn es sich bei der Eingabemaske um Feature-Daten handelt, werden Zellen in dem Eingabe-Raster, dessen Mittelpunkt in der angegebenen Form des Features liegt, in die Ausgabe aufgenommen, während Zellen mit außerhalb liegendem Mittelpunkt NoData-Werte erhalten.

Raster Layer; Feature Layer

Zu extrahierende Fläche

(Optional)

Gibt an, ob Zellen innerhalb oder außerhalb der durch die Eingabemaske definierten Positionen ausgewählt und in das Ausgabe-Raster geschrieben werden.

  • Innerhalb—Zellen innerhalb der Eingabemaske werden ausgewählt und in das Ausgabe-Raster geschrieben. Alle Zellen außerhalb der Maske erhalten NoData-Werte im Ausgabe-Raster. Dies ist die Standardeinstellung.

  • Außerhalb—Zellen außerhalb der Eingabemaske werden ausgewählt und in das Ausgabe-Raster geschrieben. Alle von der Maske bedeckten Zellen erhalten NoData-Werte.

String

Analyseausdehnung

(Optional)

Die Ausdehnung, die den zu extrahierenden Bereich definiert.

Die Ausdehnung wird standardmäßig als Schnittpunkt der Werte Eingabe-Raster und Eingabe-Raster oder -Feature-Masken-Daten berechnet. Die Verarbeitung erstreckt sich bis zu den XY-Grenzen. Zellen außerhalb dieser Ausdehnung sind "NoData".

Die Koordinaten werden in den gleichen Karteneinheiten angegeben wie das Eingabe-Raster, wenn sie nicht ausdrücklich durch die Analyseumgebung festgelegt werden.

  • Aktuelle Anzeigeausdehnung Kartenansicht: Die Ausdehnung basiert auf der aktiven Karte oder Szene.

  • Ausdehnung darstellen Ausgleichen und Beenden: Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde.

  • Ausdehnung eines Layers Layer: Die Ausdehnung basiert auf einem aktiven Karten-Layer. Wählen Sie einen verfügbaren Layer aus, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern. Jeder Karten-Layer bietet die folgenden Optionen:

    • Alle Features Alles auswählen: Die Ausdehnung aller Features.

    • Ausgewählte Features Bereich aus ausgewählten Features: Die Ausdehnung der ausgewählten Features.

    • Sichtbare Features Ausdehnungsindikator: Die Ausdehnung sichtbarer Features.

  • Durchsuchen Durchsuchen: Die Ausdehnung basiert auf einem Dataset.

  • Zwischenablage Einfügen: Die Ausdehnung kann in die und aus der Zwischenablage kopiert werden.

    • Ausdehnung kopieren Kopieren: Kopiert die Ausdehnung und das Koordinatensystem in die Zwischenablage.

    • Ausdehnung einfügen Einfügen: Fügt die Ausdehnung und das Koordinatensystem aus der Zwischenablage ein. Wenn die Zwischenablage kein Koordinatensystem enthält, wird für die Ausdehnung das Koordinatensystem der Karte verwendet.

  • Ausdehnung zurücksetzen Zurücksetzen: Die Ausdehnung wird auf den Standardwert zurückgesetzt.

Wenn die Koordinaten manuell eingegeben wurden, dann müssen die Koordinaten numerische Werte sein und im Koordinatensystem der aktiven Karte liegen. Die Karte kann statt der angegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.

Extent

Rückgabewert

Beschriftung Erläuterung Datentyp

Ausgabe-Raster

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

Raster

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Komprimierung, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maske, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Scratch-Workspace, Fang-Raster, Kachelgröße

Lizenzierungsinformationen

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