| 标注 | 说明 | 数据类型 |
输入雷达数据 | 输入雷达数据。 | Raster Dataset; Raster Layer |
输出栅格 | 检测到的深色海洋区域的输出二进制栅格。 值 1 对应于检测到的深色区域。 | Raster Dataset |
最小面积 (可选) | 要检测的最小面积。 大小不能为负值。 默认值为 10000 平方米。 | Areal Unit |
掩膜要素 (可选) | 陆地或水体面要素。 此面将用于创建掩膜。 | Feature Layer |
要素类型 (可选) | 指定掩膜要素参数值表示的面类型。 如果指定掩膜要素参数，则此参数为必需项。
| String |
DEM 栅格 (可选) | 输入 DEM。 如果输入雷达数据未经过正射校正，则将使用此 DEM 对其进行正射校正。 如果未提供掩膜要素参数值，则此 DEM 也将用于创建陆地掩膜。 | Mosaic Layer; Raster Layer |
应用大地水准面校正 (可选) | 指定是否将输入 DEM 的垂直参考系统转换为椭球体高度。 大多数高程数据集均参考海平面正高，因此在这些情况下，需要进行校正以将海平面正高转换为椭球体高度。
| Boolean |
掩膜容差 (可选) | 根据掩膜要素参数或 DEM 栅格参数创建的掩膜周围的缓冲距离。 此距离不能为负。 默认值是 100 米。 | Linear Unit |
获得 Image Analyst 许可后可用。
摘要
识别属于石油泄漏或藻类的潜在深色像素，对这些像素进行聚类，同时屏蔽感兴趣区域之外的合成孔径雷达 (SAR) 数据。
此工具使用最小面积参数过滤聚类，并将结果创建为二进制栅格。 值 1 对应于检测到的深色区域，并以随机颜色进行符号化。 值 0 指示未检测到任何深色区域，并以完全透明的方式进行符号化。
正射校正和非正射校正雷达数据均为有效输入。 由于数据位于雷达坐标中，因此非正射校正雷达数据可改善方位角伪影过滤。
使用情况
可以使用应用辐射定标工具将输入激光雷达数据校准至 gamma-nought，从而优化区域检测。 这在较大的激光雷达场景中尤其有效。
要确保仅检测海洋区域，请为掩膜要素参数提供一个值，并使用要素类型参数指定掩膜为水体还是陆地。 或者，提供 DEM 栅格参数值，该工具将使用高程以确定陆地和水体像素。 这两种方法中的任何一种都可以用于创建陆地掩膜。
如果同时提供了掩膜要素和 DEM 栅格参数值，则将使用掩膜要素参数来创建掩膜。
显示了深色海洋区域的水体和陆地掩膜。
参数
DetectDarkOceanAreas(in_radar_data, out_raster, {min_area}, {mask_features}, {feature_type}, {in_dem_raster}, {geoid}, {mask_tolerance})| 名称 | 说明 | 数据类型 |
in_radar_data | 输入雷达数据。 | Raster Dataset; Raster Layer |
out_raster | 检测到的深色海洋区域的输出二进制栅格。 值 1 对应于检测到的深色区域。 | Raster Dataset |
min_area (可选) | 要检测的最小面积。 大小不能为负值。 默认值为 10000 平方米。 | Areal 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.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")本示例使用陆地掩膜检测深色海洋区域。
# 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)