| Beschriftung | Erläuterung | Datentyp |
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.
| 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.
| Boolean |
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.
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
CreateBinaryMask(in_raster, out_raster, {background_value}, {flood_fill}, {expand_background}, {expand_mask}, {min_region_size}, {background_nodata})| Name | Erläuterung | Datentyp |
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.
| 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.
| Boolean |
Codebeispiel
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')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')Umgebungen
Lizenzinformationen
- Basic: Erfordert Image Analyst
- Standard: Erfordert Image Analyst
- Advanced: Erfordert Image Analyst