Nibble (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Ersetzt die Zellen eines Rasters entsprechend einer Maske durch den Wert des nächsten Nachbarn.

Weitere Informationen zur Funktionsweise des Werkzeugs "Nibble"

Abbildung

Abbildung Werkzeug "Nibble"
OutRas = Nibble(InRas1, Mask_Ras)

Verwendung

  • Mit dem Werkzeug Nibble können Sie Bereiche eines Rasters auswählen und diesen den Wert des nächsten Nachbarn zuweisen. Das Werkzeug kann zum Ersetzen der Werte einzelner Zellen durch die Werte der unmittelbar benachbarten Zellen verwendet werden. In größeren Maskenbereichen können auch größere Streifen von Zellen ersetzt werden.

    Ein gängiger Einsatzbereich ist die Bearbeitung von Bereiche eines Rasters mit fehlerhaften Daten.

  • NoData-Zellen im Eingabemasken-Raster definieren, welche Zellen ersetzt werden. Positionen im Eingabe-Raster, die sich außerhalb des Maskenbereichs befinden, werden nicht ersetzt. Ihr Ausgabewert entspricht dem Eingabewert.

    NoData-Zellen, die sich im Eingabe-Raster nicht in der Maske befinden, werden nicht ersetzt. Ungeachtet der Einstellungen der beiden NoData-Parameter bleiben die Zellen als NoData-Zellen erhalten.

  • Dieses Werkzeug unterstützt die parallele Verarbeitung. Wenn Ihr Computer mit mehreren Prozessoren oder mit Prozessoren, die mehrere Kerne haben, ausgestattet ist, kann eine höhere Leistung erzielt werden, vor allem bei größeren Datasets. Weitere Informationen zu dieser Funktion sowie zu den Konfigurationsmöglichkeiten finden Sie im Hilfethema Parallele Verarbeitung mit Spatial Analyst.

    Beim Einsatz von paralleler Verarbeitung werden für die Verwaltung der zu verarbeitenden Datenblöcke temporäre Daten generiert. Der Standardordner für temporäre Daten befindet sich auf Ihrem lokalen Laufwerk C. Sie können den Speicherort ändern, indem Sie eine Systemumgebungsvariable mit dem Namen TempFolders einrichten und den Pfad zum gewünschten Ordner angeben (z. B. E:\RasterCache). Wenn Sie über Admin-Berechtigungen für Ihren Computer verfügen, können Sie dies auch mit einem Registrierungsschlüssel (z. B. [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]) tun.

    Das Werkzeug verwendet standardmäßig 50 % der verfügbaren Kerne. Wenn die Eingabedaten aus weniger als 5.000 Zeilen und 5.000 Spalten mit Zellen bestehen, können weniger Kerne verwendet werden. Sie können die Anzahl der Kerne, die das Werkzeug verwendet, mit der Umgebung Faktor für parallele Verarbeitung ändern.

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Eingabe-Raster gibt die maskierten Positionen an, die durch den Wert des nächsten Nachbarn ersetzt werden sollen.

Das Eingabe-Raster kann ein ganzzahliger Wert oder ein Gleitkommawert sein.

Raster Layer
Eingabe-Masken-Raster

Das Raster, das die zu ersetzenden Positionen im Eingabe-Raster identifiziert.

Zellen mit dem Wert "NoData" werden als Zellen in der maskierten Fläche behandelt. Diese Positionen im Ausgabe-Raster werden durch den Wert des nächsten Nachbarn im Wert Eingabe-Raster ersetzt.

Das Maskierungs-Raster kann ein Ganzzahl- oder ein Gleitkommawert sein.

Raster Layer
NoData-Werte verwenden, falls sie der nächste Nachbar sind
(optional)

Gibt an, ob NoData-Zellen im Eingabe-Raster Zellen in den maskierten Flächen ersetzen können, wenn es sich dabei um den nächsten Nachbarn handelt.

  • Aktiviert: Sowohl NoData-Werte als auch Datenwerte können Zellen in der maskierten Fläche ersetzen. Dies bedeutet, dass NoData-Werte im Eingabe-Raster Flächen ersetzen können, die in der Maske definiert sind, sofern es sich dabei um den nächsten Nachbarn handelt. Dies ist die Standardeinstellung.
  • Deaktiviert: Nur Datenwerte können Zellen in der maskierten Fläche ersetzen. NoData-Werte im Eingabe-Raster können keine Flächen ersetzen, die im Maskierungs-Raster definiert sind, auch wenn es sich dabei um den nächsten Nachbarn handelt.
Boolean
Nibble für NoData-Zellen
(optional)

Gibt an, ob NoData-Zellen ob NoData-Zellen im Eingabe-Raster innerhalb der maskierten Fläche erhalten bleiben oder ersetzt werden sollen.

  • Deaktiviert: NoData-Zellen im Eingabe-Raster, die sich in der maskierten Fläche befinden, bleiben in der Ausgabe (als NoData-Zellen) erhalten. Dies ist die Standardeinstellung.
  • Aktiviert: NoData-Zellen im Eingaberaster innerhalb der maskierten Fläche werden durch den Wert des nächsten Nachbarn außerhalb der maskierten Fläche ersetzt.
Boolean
Eingabe-Zonen-Raster
(optional)

Das Eingabe-Zonen-Raster. Für jede Zone gilt, dass Eingabezellen, die sich innerhalb der Maske befinden, nur durch den Wert des nächsten Nachbarn innerhalb derselben Zone ersetzt werden.

Alle Zellen in einem Raster, die denselben Wert haben, ungeachtet dessen, ob sie aneinander grenzen oder nicht, sind eine Zone. Der Eingabezonen-Layer definiert die Form, Werte und Positionen der Zonen. Das Zonen-Raster kann ein Ganzzahl- oder ein Gleitkommawert sein.

Raster Layer

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster mit den ersetzten Zellen.

Die ermittelten Eingabezellen werden durch die Werte ihres nächsten Nachbarn ersetzt.

Bei einem ganzzahligen Wert für in_raster ist auch das Ausgabe-Raster ganzzahlig. Wenn es ein Gleitkommawert ist, ist die Ausgabe ebenfalls ein Gleitkommawert.

Raster

Nibble(in_raster, in_mask_raster, {nibble_values}, {nibble_nodata}, {in_zone_raster})
NameErläuterungDatentyp
in_raster

Das Eingabe-Raster gibt die maskierten Positionen an, die durch den Wert des nächsten Nachbarn ersetzt werden sollen.

Das Eingabe-Raster kann ein ganzzahliger Wert oder ein Gleitkommawert sein.

Raster Layer
in_mask_raster

Das Raster, das die zu ersetzenden Positionen im Eingabe-Raster identifiziert.

Zellen mit dem Wert "NoData" werden als Zellen in der maskierten Fläche behandelt. Diese Positionen im Ausgabe-Raster werden durch den Wert des nächsten Nachbarn im Wert in_raster ersetzt.

Das Maskierungs-Raster kann ein Ganzzahl- oder ein Gleitkommawert sein.

Raster Layer
nibble_values
(optional)

Gibt an, ob NoData-Zellen im Eingabe-Raster Zellen in den maskierten Flächen ersetzen können, wenn es sich dabei um den nächsten Nachbarn handelt.

  • ALL_VALUESSowohl NoData-Werte als auch Datenwerte können Zellen in der maskierten Fläche ersetzen. Dies bedeutet, dass NoData-Werte im Eingabe-Raster Flächen ersetzen können, die in der Maske definiert sind, sofern es sich dabei um den nächsten Nachbarn handelt. Dies ist die Standardeinstellung.
  • DATA_ONLYNur Datenwerte können Zellen in der maskierten Fläche ersetzen. NoData-Werte im Eingabe-Raster können keine Flächen ersetzen, die im Maskierungs-Raster definiert sind, auch wenn es sich dabei um den nächsten Nachbarn handelt.
Boolean
nibble_nodata
(optional)

Gibt an, ob NoData-Zellen ob NoData-Zellen im Eingabe-Raster innerhalb der maskierten Fläche erhalten bleiben oder ersetzt werden sollen.

  • PRESERVE_NODATANoData-Zellen im Eingabe-Raster, die sich in der maskierten Fläche befinden, bleiben in der Ausgabe (als NoData-Zellen) erhalten. Dies ist die Standardeinstellung.
  • PROCESS_NODATANoData-Zellen im Eingabe-Raster innerhalb der maskierten Fläche können durch den Wert des nächsten Nachbarn außerhalb der maskierten Fläche ersetzt werden.
Boolean
in_zone_raster
(optional)

Das Eingabe-Zonen-Raster. Für jede Zone gilt, dass Eingabezellen, die sich innerhalb der Maske befinden, nur durch den Wert des nächsten Nachbarn innerhalb derselben Zone ersetzt werden.

Alle Zellen in einem Raster, die denselben Wert haben, ungeachtet dessen, ob sie aneinander grenzen oder nicht, sind eine Zone. Der Eingabezonen-Layer definiert die Form, Werte und Positionen der Zonen. Das Zonen-Raster kann ein Ganzzahl- oder ein Gleitkommawert sein.

Raster Layer

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster mit den ersetzten Zellen.

Die ermittelten Eingabezellen werden durch die Werte ihres nächsten Nachbarn ersetzt.

Bei einem ganzzahligen Wert für in_raster ist auch das Ausgabe-Raster ganzzahlig. Wenn es ein Gleitkommawert ist, ist die Ausgabe ebenfalls ein Gleitkommawert.

Raster

Codebeispiel

Nibble: Beispiel 1 (Python-Fenster)

In diesem Beispiel werden durch die Maskeneingabe ermittelte Zellen durch Werte ersetzt, die durch die nächsten Nachbarn des Eingabe-Rasters bestimmt werden.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
nibbleOut = Nibble("land", "snow", "DATA_ONLY")
nibbleOut.save("C:/sapyexamples/output/nibbleout")
Nibble: Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden durch die Maskeneingabe ermittelte Zellen durch Werte ersetzt, die durch die nächsten Nachbarn des Eingabe-Rasters bestimmt werden.

# Name: Nibble_Ex_02.py
# Description: Replaces cells of a raster corresponding to a mask 
#              with the values of the nearest neighbors.
# 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 = "land"
inMask = "snow"

# Execute Nibble
nibbleOut = Nibble(inRaster, inMask, "ALL_VALUES")

# Save the output 
nibbleOut.save("C:/sapyexamples/output/outnibble")

Lizenzinformationen

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

Verwandte Themen