Binäre Maske erstellen (Image Analyst)

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Konvertiert ein Eingabe-Raster-Dataset in ein binäres Raster. Pixel werden basierend auf benutzerdefinierten Werten als Maske oder Hintergrund eingestuft.

Verwendung

  • Dieses Werkzeug klassifiziert ein Eingabe-Raster auf der Basis von Parameterwerten als Hintergrund oder Maske und gibt ein binäres Maskierungs-Raster aus, bei dem der Wert 1 für Maskenpixel und der Wert 0 für Hintergrundpixel steht.

    Hinweis:

    Erstellen Sie den Ausgangshintergrund des Eingabe-Rasters, indem Sie zunächst eine Threshold-Funktion wie Neuzuordnung, Binaräre Schwellenwertfunktion, Zonale Neuzuordnung, Maskierung, mathematische Operatoren (<, <, >, >) oder eine andere Funktion verwenden.

  • Wenn das binäre Ausgabe-Maskierungs-Raster auf ein Raster angewendet wird, werden die Pixel, die die Hintergrund-Pixel des Maskierungs-Rasters überlagern, in NoData umgewandelt.

  • Mit diesem Werkzeug können Sie kleine Regionen entfernen, Regionen verkleinern oder erweitern, kleine Hintergrundregionen füllen und Grenzen glätten.

  • Mit dem Parameter Flutfüllung aus Bildbegrenzung können Sie angeben, ob Pixel innerhalb der Maskierungsgrenze als Hintergrund klassifiziert werden.

  • Verwenden Sie den Parameter Flutfüllung aus Bildbegrenzung, wenn Sie die Maske einer Insel erstellen möchten und die Wasserpixel auf der Insel als Maskenwerte beibehalten möchten. Das Werkzeug führt eine Flutfüllung für die Wasserpixel aus und endet bei Erreichen der Landpixel. Die Grenzen der Ausgabe-Maskierung bleiben bestehen.

    Ergebnisse des Parameters "Flutfüllung aus Bildbegrenzung"
    Parameter "Flutfüllung aus Bildbegrenzung" aktiviert (erstes Bild und deaktiviert (zweites Bild).

  • Die Werte der Parameter Maske einblenden und Hintergrund einblenden werden in der Einheit Pixel angegeben. Die Werte können auch negativ sein, was dazu führt, dass die Maske und der Hintergrund verkleinert werden.

  • Wenn Sie kleine Gruppen von Hintergrundpixeln enfernen möchten, verwenden Sie für den Parameter Maske einblenden einen negativen und für den Parameter Hintergrund einblenden einen positiven Wert.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Eingabe-Raster-Dataset. Wenn die Eingabe ein Multiband ist, wird standardmäßig das erste Band verwendet.

Mosaic Layer; Raster Layer; Image Service; String; Raster Dataset; Mosaic Dataset
Ausgabe-Maskierungs-Raster

Das binäre Ausgabe-Raster-Dataset. Unterstützte Formate: TIFF, CRF und PNG.

Raster Dataset
Hintergrundwert
(optional)

Der Hintergrundwert für das Ausgabe-Raster. Der Standardwert ist 0.

Double
Flutfüllung aus Bildbegrenzung
(optional)

Gibt an, wie die Hintergrundpixelwerte bestimmt werden.

  • Aktiviert: Hintergrundpixelwerte werden durch die Flutfülloperation bestimmt, bei der die verbundenen Pixel von der Bildbegrenzung aus in Richtung Maskenbegrenzung gefüllt werden. Pixel innerhalb der Maske werden unabhängig von ihrem Wert nicht in Hintergrundpixel umgewandelt.
  • Deaktiviert: Hintergrundpixelwerte werden durch den angegebenen Hintergrundwert bestimmt. Dies ist die Standardeinstellung.

Boolean
Hintergrund einblenden
(optional)

Die Anzahl der Pixel, die zum Einblenden oder Verkleinern des Hintergrunds verwendet werden. Bei negativen Werten wird der Hintergrund verkleinert.

Long
Maske einblenden
(optional)

Die Anzahl der Pixel, die zum Einblenden oder Verkleinern der Maske verwendet werden. Bei negativen Werten wird die Maske verkleinert.

Long
Mindestgröße der Maskierungsregion
(optional)

Die Anzahl der verbundenen Pixel, die zum Definieren einer Maskenregion verwendet werden. Maskenregionen, die diese Größe unterschreiten, werden als Hintergrund klassifiziert.

Long
Hintergrund als NoData festlegen
(optional)

Gibt an, ob der Hintergrundwert als NoData festgelegt wird.

  • Aktiviert: Der Hintergrundwert wird als NoData festgelegt.
  • Deaktiviert: Der Hintergrundwert wird nicht als NoData festgelegt. Dies ist die Standardeinstellung.

Boolean

CreateBinaryMask(in_raster, out_raster, {background_value}, {flood_fill}, {expand_background}, {expand_mask}, {min_region_size}, {background_nodata})
NameErläuterungDatentyp
in_raster

Das Eingabe-Raster-Dataset. Wenn die Eingabe ein Multiband ist, wird standardmäßig das erste Band verwendet.

Mosaic Layer; Raster Layer; Image Service; String; Raster Dataset; Mosaic Dataset
out_raster

Das binäre Ausgabe-Raster-Dataset. Unterstützte Formate: TIFF, CRF und PNG.

Raster Dataset
background_value
(optional)

Der Hintergrundwert für das Ausgabe-Raster. Der Standardwert ist 0.

Double
flood_fill
(optional)

Gibt an, wie die Hintergrundpixelwerte bestimmt werden.

  • FLOOD_FILLHintergrundpixelwerte werden durch die Flutfülloperation bestimmt, bei der die verbundenen Pixel von der Bildbegrenzung aus in Richtung Maskenbegrenzung gefüllt werden. Pixel innerhalb der Maske werden unabhängig von ihrem Wert nicht in Hintergrundpixel umgewandelt.
  • NO_FLOOD_FILLHintergrundpixelwerte werden durch den angegebenen Hintergrundwert bestimmt. Dies ist die Standardeinstellung.
Boolean
expand_background
(optional)

Die Anzahl der Pixel, die zum Einblenden oder Verkleinern des Hintergrunds verwendet werden. Bei negativen Werten wird der Hintergrund verkleinert.

Long
expand_mask
(optional)

Die Anzahl der Pixel, die zum Einblenden oder Verkleinern der Maske verwendet werden. Bei negativen Werten wird die Maske verkleinert.

Long
min_region_size
(optional)

Die Anzahl der verbundenen Pixel, die zum Definieren einer Maskenregion verwendet werden. Maskenregionen, die diese Größe unterschreiten, werden als Hintergrund klassifiziert.

Long
background_nodata
(optional)

Gibt an, ob der Hintergrundwert als NoData festgelegt wird.

  • BACKGROUND_NODATADer Hintergrundwert wird als NoData festgelegt.
  • BACKGROUND_DATADer Hintergrundwert wird nicht als NoData festgelegt. Dies ist die Standardeinstellung.
Boolean

Codebeispiel

CreateBinaryMask (Python-Fenster)

In diesem Beispiel wird ein binäres Raster erstellt, in dem alle Pixel innerhalb der Maskenbegrenzung gefüllt werden.

#Import system modules and check out extension
import arcpy 
from arcpy.ia import *
arcpy.CheckOutExtension("ImageAnalyst") 

#Execute
output = arcpy.ia.CreateBinaryMask(r'C:\data\in_raster.crf”, 0, True, 0, 0, 100, 'BACKGROUND_DATA'') 

#Save output
output.save('c:\data\out_mask.tif')
CreateBinaryMask (eigenständiges Skript)

In diesem Beispiel wird ein binäres Raster erstellt, in dem alle Pixel innerhalb der Maskenbegrenzung gefüllt werden.

# Import system modules and check out ArcGIS Image Analyst extension license
import arcpy 
from arcpy.ia import *
arcpy.CheckOutExtension("ImageAnalyst") 

#Set local variables
in_raster = r'C:\data\input_raster.crf'         
background_value=0        
flood_fill=True     
expand_background=0        
expand_mask=0     
min_region_size=100       
background_nodata=False     
   
#Execute
out_raster = arcpy.ia.CreateBinaryMask(in_raster, background_value, flood_fill, 
				expand_background, expand_mask, min_region_size, 
				background_nodata)

#Save the output
out_raster.save(r'C:\Data\FloodMap\WaterMask.crf')

Verwandte Themen