tb_keypoints_to_image2d — 2D typed op

数据种类:keypointsimage

调用:fullseye.apply(img, "tb_keypoints_to_image2d", a=0.5, b=0.5)(2-D 的模型是一张图 + 两个标量旋钮 a,b∈[0,1])

用法

图像坐标 `(N,2) = (u, v) → 计数图像 (H, W)keypoints` 的第二个出口。

> 以下的详细说明为原文 —— 摘要与标题已翻译。

`round(v) を行、round(u)` を列として 1 ずつ加算する。**画素格子への

量子化が損失**で、:func:keypoints_from_image2d と往復すると位置が

最大 0.5 画素ずれる(よく離れた 225 点での実測: 軸あたり RMS 0.2835 px =

一様量子化の理論値 1/sqrt(12) = 0.2887 と一致。2-D 距離では sqrt(2) 倍の

0.4009 px で、理論 sqrt(2/12) = 0.4082)。

★ここも一度間違えた: 2-D 距離の実測を 1-D の理論値と並べて「0.29 のはずが

0.40 だ」と読みかけた —— 軸ごとの量と距離の量を混ぜると、正しい実装が

誤っているように見える。

近接した点は連結成分として融合するので、往復で点数も減りうる

(実測: 60 点をランダムに置くと 54 点)。

範囲外の点は黙って捨てない —— 捨てると「検出が減った」のか

「画像が小さすぎた」のかが区別できなくなる。

Args:

keypoints: (N, 2) の (u, v)。

shape: (H, W)。

Returns:

(H, W) float64 の計数画像。

Raises:

ValueError: 形状不正 / 非有限 / 範囲外の点がある / shape が上限超。

2-D 進化レジストリへ橋渡しした reprconv の op `keypoints_to_image2d。実装は同じで、呼び出し規約だけ op(v, a, b) に合わせてある。この op に調整点は無く、ab` も使われない。

参考(示例数据・文献)

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

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

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

• (暂无)

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

identity · gaussian · mean_box · bilateral · unsharp · median · min_filter · max_filter

同类别(typed)

tb_points_to_voxel · tb_estimate_point_normals · tb_iss_keypoints · tb_angle_3points · tb_project_points · tb_render_point_depth · tb_statistical_outlier_removal · tb_radius_outlier_removal


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

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.