polygon_two_point_depth — DRIVE pegsym op

• Datenarten: matrix × matrix × scalar → table

• Aufruf: import fullseye as fs; fs.ledger.polygon_two_point_depth(peg_vertices, hole_vertices, theta: 'float', tilt_dir: 'float' = 0.0, depth_max: 'float' = 0.05, tol: 'float' = 1e-10) -> 'dict' (die Implementierung direkt: import pegsym; pegsym.polygon_two_point_depth(peg_vertices, hole_vertices, theta: 'float', tilt_dir: 'float' = 0.0, depth_max: 'float' = 0.05, tol: 'float' = 1e-10) -> 'dict'; aus dem Register: opsdrive.get("polygon_two_point_depth"))

Verwendung

Exakte Tiefe des Zweipunktkontakts l₂ [m] (von der engsten Stelle z = 0 bis zur Mitte der Spitze) eines gekippten polygonalen Stifts: Der Teil des Stifts bei z ≤ 0 in der Tiefe l ist die konvexe Hülle der Vertices der Spitzenfläche und der Punkte, an denen die Seitenkanten z = 0 schneiden. Da die Bohrung ein senkrechtes Prisma ist, tritt der Stift ein, solange die horizontale Projektion dieser Vertices per Translation in die Bohrung passt (polygon_fit_check), und passt nicht mehr, wenn l tiefer wird — diese Grenze wird per Bisektion bestimmt. tilt_dir = horizontale Kipprichtung [rad] (Weltkoordinaten, dasselbe System wie der Stiftquerschnitt). Die Kreisformel zum Vergleich (Whitney; die exakte 3-D-Zylinderformel von pegsim (2R − r(cos θ + sec θ))/tan θ) wird für den Inkreis (r = A, R = A + δ) und den Umkreis (r = A/cos(π/n), R = (A + δ)/cos(π/n)) zurückgegeben (circle_in, circle_out). Der Kleinwinkel-Grenzfall für ein um eine flächenparallele Achse gekipptes Quadrat ist Gl. (2.28) von Goli et al. 2024, φ = (v − v′)/h, also l₂ tan θ → 2δ (goli_small_angle = 2δ/tan θ). Bei ungeradem n (Dreieck) liegt jeder Fläche ein Vertex gegenüber, daher ist die Tiefe in jeder Richtung größer als nach der Inkreisformel. Bei geradem n stimmt sie in Richtung der Flächennormalen mit der Inkreisformel überein (1e-11 m beim Quadrat). Manche Kombinationen gehen bis zu 0.03 % über die Inkreisseite hinaus (Neigung 6°, 15° von der Fläche). Gibt l2, circle_in, circle_out und goli_small_angle zurück (δ ist die mittlere Differenz der Inkreisradien, n die Anzahl der Vertices). Raises ValueError: θ ≤ 0 oder ≥ 30°, tritt selbst gerade nicht ein, kein Zweipunktkontakt bis depth_max.

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)

• poc_peg_symmetry_search — py -3.11 examples/poc_peg_symmetry_search.py

Typkompatible Folge-Operatoren (nehmen table als Eingabe)

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

Gleiche Kategorie (pegsym)

polygon_peg · polygon_offset · polygon_fit_check · rotation_window · polygon_coverage_image · plane_topview · polygon_yaw_read · relative_yaw_from_images


*Provenance: pegsym.py — DRIVE 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.