检测亮色海洋对象 (Image Analyst)

获得 Image Analyst 许可后可用。

摘要

检测潜在的亮色人造物体(例如船舶、石油钻井平台和风车),同时屏蔽感兴趣区域之外的合成孔径雷达 (SAR) 数据。

此工具将对像素进行聚类并将按最小和最大宽度以及长度参数来过滤聚类,并将结果输出到要素类。 输出要素类可以指定为检测到的对象的面周围的边界框或周长。

使用情况

  • 可以使用应用辐射定标工具将输入激光雷达数据校准至 gamma-nought。 这将优化对象检测,尤其在大激光雷达场景中。

  • 雷达输入数据可能与输出要素类不一致。 如果输入雷达数据未正射校正,则该工具会使用 DEM 栅格参数转换输出要素类参数值。 如果未提供 DEM,则该工具将使用椭球面执行转换。 要对输出要素类参数值进行最佳转换,请为 DEM 栅格参数提供输入 DEM。 输入的 DEM 必须位于 WGS 84 (EPSG:4326) 地理坐标系中。

  • 要确保仅检测到海洋中的对象,请为掩膜要素参数提供一个值,并使用要素类型参数以指定掩膜为水体还是陆地。 或者,提供 DEM 栅格参数值,该工具将使用高程以确定陆地和水体像素。 这两种方法中的任何一种都可以用于创建陆地掩膜。

    如果同时提供了掩膜要素DEM 栅格参数值,则将使用掩膜要素参数来创建掩膜。

    亮色海洋对象的水体和土地掩膜

参数

标注说明数据类型
输入雷达数据

输入雷达数据。

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 的垂直参考系统转换为椭球体高度。 大多数高程数据集均参考海平面正高,因此在这些情况下,需要进行校正以将海平面正高转换为椭球体高度。

  • 选中 - 将进行大地水准面校正以将正高转换为椭球体高度(根据 EGM96 大地水准面)。 这是默认设置。
  • 未选中 - 不会进行大地水准面校正。 仅当以椭球体高度提供 DEM 时,才会使用此选项。

Boolean
掩膜容差
(可选)

根据掩膜要素参数或 DEM 栅格参数创建的掩膜周围的缓冲距离。 此距离不能为负。 默认值是 100 米。

Linear Unit

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
(可选)

指定将用于输出要素类的边界类型。

  • BOUNDS将使用检测到的对象的最小边界框。 这是默认设置。
  • PERIMETER将使用检测到的对象的周长轮廓。

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 参数,则此参数为必需项。

  • LAND掩膜输入为陆地面。 将使用此输入创建反转掩膜。
  • WATER掩膜输入为水体面。 将使用此输入创建掩膜。

String
in_dem_raster
(可选)

输入 DEM。

如果输入雷达数据未经过正射校正,则将使用此 DEM 对其进行正射校正。

如果未提供 mask_features 参数值,则此 DEM 也将用于创建陆地掩膜。

Mosaic Layer; Raster Layer
geoid
(可选)

指定是否将输入 DEM 的垂直参考系统转换为椭球体高度。 大多数高程数据集均参考海平面正高,因此在这些情况下,需要进行校正以将海平面正高转换为椭球体高度。

  • GEOID将进行大地水准面校正以将正高转换为椭球体高度(根据 EGM96 大地水准面)。 这是默认设置。
  • NONE不会进行大地水准面校正。 仅当以椭球体高度提供 DEM 时,才会使用此选项。
Boolean
mask_tolerance
(可选)

根据 mask_features 参数或 in_dem_raster 参数创建的掩膜周围的缓冲距离。 此距离不能为负。 默认值是 100 米。

Linear Unit

代码示例

DetectBrightOceanObjects 示例 1(Python 窗口)

本示例使用水体掩膜查找亮色海洋对象。

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")
DetectBrightOceanObjects 示例 2(独立脚本)

本示例使用水体掩膜查找亮色海洋对象。

# 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)

相关主题