Beschriftung | Erläuterung | Datentyp |
Eingaberadardaten | Die Eingaberadardaten. | Raster Dataset; Raster Layer |
Ausgabe-Raster | Das binäre Ausgabe-Raster erkannter dunkler Meeresbereiche. Der Wert 1 entspricht einer dunklen Fläche. | Raster Dataset |
Mindestfläche (optional) | Die zu erkennende Mindestfläche. Diese darf nicht negativ sein. Der Standardwert ist 10.000 Quadratmeter. | Areal Unit |
Masken-Features (optional) | Ein Land- oder Wasser-Polygon-Feature. Mithilfe dieses Polygons wird eine Maske erstellt. | Feature Layer |
Feature-Typ (optional) | Gibt den Typ des Polygons an, den der Wert des Parameters Masken-Features darstellt. Dieser Parameter ist erforderlich, wenn der Parameter Masken-Features angegeben ist.
| String |
DEM-Raster (optional) | Das Eingabe-DEM. Wenn die Eingaberadardaten nicht orthorektifiziert sind, wird dieses DEM für die Orthorektifizierung der Daten verwendet. Wird der Wert des Parameters Masken-Features nicht angegeben, wird dieses DEM auch für die Erstellung einer Landmaske verwendet. | Mosaic Layer; Raster Layer |
Geoid-Korrektur anwenden (optional) | Gibt an, ob das vertikale Bezugssystem des Eingabe-DEM in ellipsoidförmige Höhe transformiert wird. Die meisten Höhen-Datasets werden auf orthometrische Höhe über dem Meeresspiegel referenziert, sodass eine Korrektur in diesen Fällen zum Konvertieren in ellipsoidförmige Höhe erforderlich ist.
| Boolean |
Maskentoleranz (optional) | Der Pufferabstand, der die Maske umgibt, die entweder durch den Parameter Masken-Features oder den Parameter DEM-Raster erstellt wurde. Die Entfernung darf nicht negativ sein. Der Standardwert beträgt 100 Meter. | Linear Unit |
Mit der Image Analyst-Lizenz verfügbar.
Zusammenfassung
Erkennt potenzielle dunkle Pixel, die zu Ölteppichen oder Algen gehören, und clustert diese Pixel. Gleichzeitig werden die SAR-Daten (Synthetic Aperture Radar) außerhalb der Interessensregion markiert.
Das Werkzeug filtert Cluster mithilfe des Parameters Mindestfläche und gibt das Ergebnis als binäres Raster aus. Der Wert 1 entspricht dabei dunklen Flächen und wird mit einer zufällig gewählten Farbe symbolisiert. Der Wert 0 gibt an, dass keine dunklen Flächen erkannt wurden und wird vollständig transparent symbolisiert.
Sowohl orthorektifizierte als auch nicht orthorektifizierte Radardaten sind gültige Eingaben. Nicht orthorektifizierte Radardaten führen zu einer verbesserten Filterung von Azimut-Artefakten, da die Daten in Radarkoordinaten vorliegen.
Verwendung
Optimieren Sie die Flächenerkennung, indem Sie die Eingabe-Radardaten mit dem Werkzeug Radiometrische Kalibrierung anwenden auf Gamma-Nought kalibrieren. Dies ist besonders bei größeren Radarszenen effektiv.
Wenn Sie sicherstellen möchten, dass nur Bereiche im Meer erkannt werden, geben Sie einen Wert für den Parameter Masken-Features an, und legen Sie mithilfe des Parameters Feature-Typ fest, ob die Maske für Wasser oder Land erstellt wird. Alternativ können Sie einen Wert für den Parameter DEM-Raster angeben. Das Werkzeug bestimmt Land- und Wasserpixel dann anhand der Höhe. Beide Methoden können zur Erstellung einer Landmaske verwendet werden.
Werden sowohl für den Parameter Masken-Features als auch für den Parameter DEM-Raster Parameterwerte bereitgestellt, wird der Parameter Masken-Features für die Maskenerstellung verwendet.
Parameter
DetectDarkOceanAreas(in_radar_data, out_raster, {min_area}, {mask_features}, {feature_type}, {in_dem_raster}, {geoid}, {mask_tolerance})
Name | Erläuterung | Datentyp |
in_radar_data | Die Eingaberadardaten. | Raster Dataset; Raster Layer |
out_raster | Das binäre Ausgabe-Raster erkannter dunkler Meeresbereiche. Der Wert 1 entspricht einer dunklen Fläche. | Raster Dataset |
min_area (optional) | Die zu erkennende Mindestfläche. Diese darf nicht negativ sein. Der Standardwert ist 10.000 Quadratmeter. | Areal Unit |
mask_features (optional) | Ein Land- oder Wasser-Polygon-Feature. Mithilfe dieses Polygons wird eine Maske erstellt. | Feature Layer |
feature_type (optional) | Gibt den Typ des Polygons an, den der Wert des Parameters mask_features darstellt. Dieser Parameter ist erforderlich, wenn der Parameter mask_features angegeben ist.
| String |
in_dem_raster (optional) | Das Eingabe-DEM. Wenn die Eingaberadardaten nicht orthorektifiziert sind, wird dieses DEM für die Orthorektifizierung der Daten verwendet. Wird der Wert des Parameters mask_features nicht angegeben, wird dieses DEM auch für die Erstellung einer Landmaske verwendet. | Mosaic Layer; Raster Layer |
geoid (optional) | Gibt an, ob das vertikale Bezugssystem des Eingabe-DEM in ellipsoidförmige Höhe transformiert wird. Die meisten Höhen-Datasets werden auf orthometrische Höhe über dem Meeresspiegel referenziert, sodass eine Korrektur in diesen Fällen zum Konvertieren in ellipsoidförmige Höhe erforderlich ist.
| Boolean |
mask_tolerance (optional) | Der Pufferabstand, der die Maske umgibt, die entweder durch den Parameter mask_features oder den Parameter in_dem_raster erstellt wurde. Die Entfernung darf nicht negativ sein. Der Standardwert beträgt 100 Meter. | Linear Unit |
Codebeispiel
In diesem Beispiel werden dunkle Meeresbereiche unter Verwendung einer Landmaske gesucht.
import arcpy
arcpy.env.workspace = r"C:\Data\SAR"
out = arcpy.ia.DetectDarkOceanAreas(
"IW_manifest_CalG0", "20 SquareKilometers", "land_polygons",
"LAND", "dem_COP30_ortho.tif", "GEOID", "100 Meters")
out.save("IW_manifest_CalG0_Dspk_DDOA.crf")
In diesem Beispiel werden dunkle Meeresbereiche unter Verwendung einer Landmaske gesucht.
# Import system modules and check out ArcGIS Image Analyst extension license
import arcpy
arcpy.CheckOutExtension("ImageAnalyst")
from arcpy.ia import *
# Set local variables
arcpy.env.workspace = r"C:\Data\SAR"
in_radar_data="IW_manifest_CalG0"
out_raster="IW_manifest_CalG0_DDOA.crf"
min_area="20 SquareKilometers"
mask_features= "land_polygons"
feature_type="LAND"
in_dem_raster="dem_COP30_ortho.tif"
geoid="GEOID"
mask_tolerance="100 Meters"
# Execute
out = arcpy.ia.DetectDarkOceanAreas(
in_radar_data, out_raster, min_area, mask_features, feature_type,
in_dem_raster, geoid, mask_tolerance)
out.save(out_raster)