Beschriftung | Erläuterung | Datentyp |
Eingaberadardaten | Die Eingaberadardaten. | Raster Dataset; Raster Layer |
Ausgabe-Feature-Class | Die Ausgabe-Feature-Class erkannter heller Meeresobjekte. | Feature Class |
Ausgabetyp (optional) | Gibt die Art der Grenze an, die für die Ausgabe-Feature-Class verwendet wird.
| String |
Minimale Objektbreite (optional) | Die minimale Breite eines zu erkennenden Objekts. Die Breite muss ein positiver Wert sein. Der Standardwert beträgt 10 Meter. | Linear Unit |
Maximale Objektbreite (optional) | Die maximale Breite eines zu erkennenden Objekts. Die Breite muss ein positiver Wert sein. Der Standardwert beträgt 100 Meter. | Linear Unit |
Minimale Objektlänge (optional) | Die minimale Länge eines zu erkennenden Objekts. Die Länge muss ein positiver Wert sein. Der Standardwert beträgt 50 Meter. | Linear Unit |
Maximale Objektlänge (optional) | Die maximale Länge eines zu erkennenden Objekts. Die Länge muss ein positiver Wert sein. Die Standardeinstellung ist 500 Meter. | Linear 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 helle Objekte, die vom Menschen geschaffen wurden, z. B Schiffe, Bohrinseln und Windmühlen. Gleichzeitig werden die SAR-Daten (Synthetic Aperture Radar) außerhalb der Interessensregion maskiert.
Das Werkzeug bildet Pixel-Cluster, filtert die Cluster nach den Parameterwerten für minimale und maximale Breite und Länge und gibt die Ergebnisse in eine Feature-Class aus. Die Ausgabe-Feature-Class kann als umgebendes Rechteck oder als Umfang um das Polygon für die erkannten Objekte angegeben werden.
Verwendung
Kalibrieren Sie die Eingabe-Radardaten mit dem Werkzeug Radiometrische Kalibrierung anwenden auf Gamma-Nought. Dadurch wird die Objekterkennung optimiert, insbesondere bei großen Radarszenen.
Die Eingaberadardaten sind möglicherweise nicht mit der Ausgabe-Feature-Class ausgerichtet. Wenn die Eingaberadardaten nicht orthorektifiziert sind, transformiert das Werkzeug den Parameterwert der Ausgabe-Feature-Class mithilfe des Parameters DEM-Raster. Wenn kein DEM angegeben ist, führt das Werkzeug eine Transformation mithilfe einer ellipsoidförmigen Oberfläche durch. Geben Sie für eine optimale Transformation des Parameterwerts Ausgabe-Feature-Class ein Eingabe-DEM für den Parameter DEM-Raster an. Das Eingabe-DEM muss im geographischen Koordinatensystem WGS84 (EPSG:4326) vorliegen.
Wenn Sie sicherstellen möchten, dass nur Objekte 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
DetectBrightOceanObjects(in_radar_data, out_feature_class, {out_type}, {min_object_width}, {max_object_width}, {min_object_length}, {max_object_length}, {mask_features}, {feature_type}, {in_dem_raster}, {geoid}, {mask_tolerance})
Name | Erläuterung | Datentyp |
in_radar_data | Die Eingaberadardaten. | Raster Dataset; Raster Layer |
out_feature_class | Die Ausgabe-Feature-Class erkannter heller Meeresobjekte. | Feature Class |
out_type (optional) | Gibt die Art der Grenze an, die für die Ausgabe-Feature-Class verwendet wird.
| String |
min_object_width (optional) | Die minimale Breite eines zu erkennenden Objekts. Die Breite muss ein positiver Wert sein. Der Standardwert beträgt 10 Meter. | Linear Unit |
max_object_width (optional) | Die maximale Breite eines zu erkennenden Objekts. Die Breite muss ein positiver Wert sein. Der Standardwert beträgt 100 Meter. | Linear Unit |
min_object_length (optional) | Die minimale Länge eines zu erkennenden Objekts. Die Länge muss ein positiver Wert sein. Der Standardwert beträgt 50 Meter. | Linear Unit |
max_object_length (optional) | Die maximale Länge eines zu erkennenden Objekts. Die Länge muss ein positiver Wert sein. Die Standardeinstellung ist 500 Meter. | Linear 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 helle Meeresobjekte unter Verwendung einer Wassermaske gesucht.
import arcpy
arcpy.ia.DetectBrightOceanObjects(
r"C:\Data\SAR\Spotlight High_ICEYE_GRD_SLH_50153_20210405T124010_CalG0.crf",
r"C:\Output\Ocean.gdb\DetectBrightOceanObjects", "BOUNDS",
"50 Meters", "500 Meters", "50 Meters", "500 Meters", "MPA Water Polygon",
"Water", r"C:\Data\DEM\dem_COP30_ortho.tif", "GEOID", "100 Meters")
In diesem Beispiel werden helle Meeresobjekte unter Verwendung einer Wassermaske gesucht.
# Import system modules and check out ArcGIS Image Analyst extension license
import arcpy
arcpy.CheckOutExtension("ImageAnalyst")
from arcpy.ia import *
# Set local variables
in_radar_data= r"C:\Data\SAR\IW_manifest_CalG0.crf"
out_feature_class = r"C:\Output\Ocean.gdb\DetectBrightOceanObjects"
out_type = "BOUNDS"
min_object_width = "50 Meters"
max_object_width = "500 Meters"
min_object_length = "50 Meters"
max_object_length = "500 Meters"
mask_features = "MPA Water Polygon"
feature_type = "Water"
in_dem_raster = r"C:\Data\DEM\dem_COP30_ortho.tif"
geoid = "GEOID"
mask_tolerance = "100 Meters"
# Execute
arcpy.ia.DetectBrightOceanObjects(in_radar_data, out_feature_class, out_type,
min_object_width, max_object_width, min_object_length,
max_object_length, mask_features, feature_type, in_dem_raster,
geoid, mask_tolerance)