| 标注 | 说明 | 数据类型 |
输入雷达数据 | 输入雷达数据。 | Raster Dataset; Raster Layer |
输出要素类 | 检测到的亮色海洋对象的输出要素类。 | Feature Class |
输出类型 (可选) | 指定将用于输出要素类的边界类型。
| String |
最小对象宽度 (可选) | 待检测对象的最小宽度。 宽度必须为正值。 默认值为 10 米。 | Linear Unit |
最大对象宽度 (可选) | 待检测对象的最大宽度。 宽度必须为正值。 默认值是 100 米。 | Linear Unit |
最小对象长度 (可选) | 待检测对象的最小长度。 长度必须为正值。 默认值是 50 米。 | Linear Unit |
最大对象长度 (可选) | 待检测对象的最大长度。 长度必须为正值。 默认值为 500 米。 | Linear Unit |
掩膜要素 (可选) | 陆地或水体面要素。 此面将用于创建掩膜。 | Feature Layer |
要素类型 (可选) | 指定掩膜要素参数值表示的面类型。 如果指定掩膜要素参数，则此参数为必需项。
| String |
DEM 栅格 (可选) | 输入 DEM。 如果输入雷达数据未经过正射校正，则将使用此 DEM 对其进行正射校正。 如果未提供掩膜要素参数值，则此 DEM 也将用于创建陆地掩膜。 | Mosaic Layer; Raster Layer |
应用大地水准面校正 (可选) | 指定是否将输入 DEM 的垂直参考系统转换为椭球体高度。 大多数高程数据集均参考海平面正高，因此在这些情况下，需要进行校正以将海平面正高转换为椭球体高度。
| Boolean |
掩膜容差 (可选) | 根据掩膜要素参数或 DEM 栅格参数创建的掩膜周围的缓冲距离。 此距离不能为负。 默认值是 100 米。 | Linear Unit |
获得 Image Analyst 许可后可用。
摘要
检测潜在的亮色人造物体（例如船舶、石油钻井平台和风车），同时屏蔽感兴趣区域之外的合成孔径雷达 (SAR) 数据。
此工具将对像素进行聚类并将按最小和最大宽度以及长度参数来过滤聚类，并将结果输出到要素类。 输出要素类可以指定为检测到的对象的面周围的边界框或周长。
使用情况
可以使用应用辐射定标工具将输入激光雷达数据校准至 gamma-nought。 这将优化对象检测，尤其在大激光雷达场景中。
雷达输入数据可能与输出要素类不一致。 如果输入雷达数据未正射校正，则该工具会使用 DEM 栅格参数转换输出要素类参数值。 如果未提供 DEM，则该工具将使用椭球面执行转换。 要对输出要素类参数值进行最佳转换，请为 DEM 栅格参数提供输入 DEM。 输入的 DEM 必须位于 WGS 84 (EPSG:4326) 地理坐标系中。
要确保仅检测到海洋中的对象，请为掩膜要素参数提供一个值，并使用要素类型参数以指定掩膜为水体还是陆地。 或者，提供 DEM 栅格参数值，该工具将使用高程以确定陆地和水体像素。 这两种方法中的任何一种都可以用于创建陆地掩膜。
如果同时提供了掩膜要素和 DEM 栅格参数值，则将使用掩膜要素参数来创建掩膜。
参数
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})| 名称 | 说明 | 数据类型 |
in_radar_data | 输入雷达数据。 | Raster Dataset; Raster Layer |
out_feature_class | 检测到的亮色海洋对象的输出要素类。 | Feature Class |
out_type (可选) | 指定将用于输出要素类的边界类型。
| String |
min_object_width (可选) | 待检测对象的最小宽度。 宽度必须为正值。 默认值为 10 米。 | Linear Unit |
max_object_width (可选) | 待检测对象的最大宽度。 宽度必须为正值。 默认值是 100 米。 | Linear Unit |
min_object_length (可选) | 待检测对象的最小长度。 长度必须为正值。 默认值是 50 米。 | Linear Unit |
max_object_length (可选) | 待检测对象的最大长度。 长度必须为正值。 默认值为 500 米。 | Linear Unit |
mask_features (可选) | 陆地或水体面要素。 此面将用于创建掩膜。 | Feature Layer |
feature_type (可选) | 指定 mask_features 参数值表示的面类型。 如果指定 mask_features 参数，则此参数为必需项。
| String |
in_dem_raster (可选) | 输入 DEM。 如果输入雷达数据未经过正射校正，则将使用此 DEM 对其进行正射校正。 如果未提供 mask_features 参数值，则此 DEM 也将用于创建陆地掩膜。 | Mosaic Layer; Raster Layer |
geoid (可选) | 指定是否将输入 DEM 的垂直参考系统转换为椭球体高度。 大多数高程数据集均参考海平面正高，因此在这些情况下，需要进行校正以将海平面正高转换为椭球体高度。
| Boolean |
mask_tolerance (可选) | 根据 mask_features 参数或 in_dem_raster 参数创建的掩膜周围的缓冲距离。 此距离不能为负。 默认值是 100 米。 | Linear Unit |
代码示例
本示例使用水体掩膜查找亮色海洋对象。
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")本示例使用水体掩膜查找亮色海洋对象。
# 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)