xg_orientation — 2D xldgeom op

Datenarten: contourfeature

Aufruf: fullseye.apply(img, "xg_orientation", a=0.5, b=0.5) (das 2-D-Modell ist ein Bild plus zwei skalare Regler a,b∈[0,1])

HALCON-Äquivalent: orientation_points_xld (Bedeutung und Parameter sind in der HALCON-Referenz nachzulesen)

Verwendung

Hauptachsenorientierung in Grad, auf [0,180) gefaltet und durch 180 skaliert.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

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.

Ausführlicher Anwendungsleitfaden

Leitfaden zur Familie gallery2d_geometry

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

gallery2d_geometrypy -3.11 examples/gallery2d_geometry.py

Typkompatible Folge-Operatoren (nehmen feature als Eingabe)

identity

Gleiche Kategorie (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. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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