ellipse — ANNOTATE `shape` op

• 数据种类:image2d → image2d

• 调用: import fullseye as fs; fs.ledger.ellipse(img, center, radii, angle_deg=0.0, color='neutral', width=2, fill=False, alpha=1.0, scheme='okabe_ito')(要直接调用实现,import annotate; annotate.ellipse(img, center, radii, angle_deg=0.0, color='neutral', width=2, fill=False, alpha=1.0, scheme='okabe_ito');从台账取用则 opsannotate.get("ellipse"))

用法

椭圆(用 angle_deg 旋转,fill=True 时填充)。

Raises

ValueError

半径非正、非有限、alpha 在 [0,1] 之外。

绘制: 把像素映射到旋转了 angle_deg 的局部坐标 (u, v), 以 q = (u/ra)^2 + (v/rb)^2 判定。fill=True 为 q <= 1, fill=False 为 |sqrt(q) - 1| <= max(1, width) / (2 min(ra, rb)) 的带(无抗锯齿)。由于带宽以短轴归一化,在扁平的椭圆上, 越靠近长轴两端线看起来越粗(近似)。

• center: (x, y),x = 列、y = 行。可以在图像外。

• radii: (ra, rb) [px]。ra 为 angle_deg 方向,rb 为其正交方向。两者均为正。

• angle_deg: 旋转角 [度]。从 x 轴顺时针(屏幕坐标,y 向下)。

• width: 线宽 [px] (fill=False 时)。

• img / color / alpha / scheme 的处理与 rounded_rect 相同(float64 副本、[0, 1]、角色名或 RGB)。

• 返回值: 与输入同形的 float64。

ra == rb 则为圆。叠加测量结果(椭圆拟合的 row, col, phi, ra, rb) 时,换读为 center=(col, row)、angle_deg=degrees(phi)。

详细使用指南

• figure_annotation 族使用指南

背景知识指南(该算子背后的物理与约定)

• dataset_conventions — 训练数据集规范知识 —— COCO / YOLO / VOC 及外观检测中的陷阱

参考(示例数据、文献)

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

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

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

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

• annotate_gallery — py -3.11 examples/annotate_gallery.py

• poc_dimensional_inspection — py -3.11 examples/poc_dimensional_inspection.py

• poc_driving_crossing — py -3.11 examples/poc_driving_crossing.py

• poc_driving_lateral — py -3.11 examples/poc_driving_lateral.py

• poc_driving_pass — py -3.11 examples/poc_driving_pass.py

• poc_machine_condition_fusion — py -3.11 examples/poc_machine_condition_fusion.py

• poc_peg_insertion_tactile — py -3.11 examples/poc_peg_insertion_tactile.py

• poc_public_camera_heading_real — py -3.11 examples/poc_public_camera_heading_real.py

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

text_box · arrow · leader_line · label_points · crosshair · legend_box · color_bar · scale_bar

同类别(`shape`)

rounded_rect · filled_polygon · arc

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

ellipse — ANNOTATE shape op

用法