skyline_extract — GEOCAM `skyline` op

• 数据种类:image2d → signal

• 调用: import fullseye as fs; fs.ledger.skyline_extract(image, sky_is_bright=True, smooth=1.5, max_jump=3, jump_penalty=0.5)(要直接调用实现,import geocam; geocam.skyline_extract(image, sky_is_bright=True, smooth=1.5, max_jump=3, jump_penalty=0.5);从台账取用则 opsgeocam.get("skyline_extract"))

用法

用动态规划从照片中提取 1 条每列的天空与地形分界所在行 → signal (W,)。

与 Lie、Lin、Hsu 2005(*Pattern Recognition*:用于导航的鲁棒天际线提取)相同的思路:

把垂直方向的亮度变化(若天空在上方且较亮,则 I[v−1] − I[v+1] 为正)作为“边界相似度”, 在相对相邻列行跳变不超过 max_jump 的连续路径中选出代价最小的一条(jump_penalty × 行的跳变)。即使云或建筑物的竖直边缘产生局部强响应,路径的连续性也会保留真正的山脊线。

Args:

image: (H, W) float。RGB 则先转为灰度。

sky_is_bright: 天空比地形亮(白天)。夜景、逆光导致反转时为 False。

smooth: 纵向的 Gaussian σ [像素] (噪声)。0 为禁用。

max_jump: 相邻列之间允许的行跳变 [像素]。

jump_penalty: 每跳变 1 像素的代价(边界相似度已归一化到 0~1)。

Returns:

signal (W,) float: 每列边界所在的行(0 为最上端)。对只拍到天空、或只拍到地形的图像,边界响应弱,路径平均代价接近 0,因此以 ValueError

终止(不悄悄返回噪声的线)。

详细使用指南

• geocam 族使用指南

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者、年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• poc_public_camera_heading — py -3.11 examples/poc_public_camera_heading.py

类型可衔接的下一个算子(可接受 `signal` 作为输入)

sun_position · camera_orientation_from_sun · camera_orientation_from_sun_candidates · camera_orientation_from_skyline

同类别(`skyline`)

dem_skyline · render_skyline_view

*Provenance: geocam.py — GEOCAM 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

skyline_extract — GEOCAM skyline op

用法