xg_orientation — 2D xldgeom op

• データ種: contour → feature

• 呼び出し: fullseye.apply(img, "xg_orientation", a=0.5, b=0.5) (2-D は 1 画像 + 2 スカラつまみ a,b∈[0,1] のモデル)

• HALCON 相当: orientation_points_xld(意味・パラメータは HALCON リファレンスが参考になる)

使い方

Principal-axis orientation in degrees, folded to [0,180) and /180 scaled.

Angle is measured from the +x (column) axis; multiply the result by 180 to

recover degrees. Line orientation is defined mod 180, so a line at theta and

theta+180 map to the same value.

Discontinuity (inherent, documented): a line orientation lives on a circle of

180 degrees, and this op unrolls it to [0, 1), so the wrap sits at HORIZONTAL —

a line tilted +0.001 deg returns ~0.0 while -0.001 deg returns ~0.9999. Any

single-scalar unrolling has a seam somewhere; callers that need continuity

across horizontal should compare orientations on the doubled angle

(cos 2*theta, sin 2*theta) or take the difference mod 1. The closing point of a

closed contour is not double-counted in the PCA.

詳しい使い方ガイド

• gallery2d_geometry ファミリ ガイド

参考(サンプルデータ・文献)

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

• アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• gallery2d_geometry — py -3.11 examples/gallery2d_geometry.py

型が繋がる次の op(feature を入力に取れる)

identity

同カテゴリ(xldgeom)

xg_moments · xg_area_center · xg_eccentricity · xg_elliptic_axis · xg_height_width_ratio · xg_regress_contours · xg_clip_contours · xg_gen_polygons

*Provenance: ops.py — 2D operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

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