town_chain — DRIVE town op

• Data kinds: any → table

• Call: import fullseye as fs; fs.ledger.town_chain(elements, *, start=(0.0, 0.0, 0.0), overlap: 'float' = 0.05) -> 'dict' (implementation को सीधे call करना हो तो import drivetown; drivetown.town_chain(elements, *, start=(0.0, 0.0, 0.0), overlap: 'float' = 0.05) -> 'dict', registry से लेना हो तो opsdrive.get("town_chain"))

उपयोग

elements को क्रम से जोड़कर रखता है: element k+1 के entry को element k के exit (उससे overlap पहले) से मिलाने वाली rigid placement closed form में निकालता है और drivecourse.course_layout को देता है।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

Parameters

elements : drivecourse の要素(dict)の列。順に継ぐ。

start : 最初の要素の entry を置く世界姿勢 (x, y, yaw)。

overlap : 継ぎ目の食い込み [m] (≥ 0。3-D 化で継ぎ目に縁石が立たないため)。要素の中心線より短いこと。

Returns

dict : course_layout の dict に "chain" を足したもの。chain = {"overlap", "s_start" (n,) 各要素の entry の弧長, "lengths" (n,) 各要素の centerline_length, "polyline_lengths" (n,) 中心線の折線長, "total_length" (= Σ 折線長 − overlap × (n − 1)), "joints": [(exit_k, entry_k+1), ...] 世界姿勢}。

Raises ValueError: 要素が空・layout の入れ子・entry/exit/centerline が無い、start/overlap が非有限、overlap が負、overlap が要素の中心線より長い。

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• poc_driving_town — py -3.11 examples/poc_driving_town.py

वे अगले ops जिनसे type जुड़ता है (table को input के रूप में लेते हैं)

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

इसी category के (town)

town_layout · town_world · town_centerline · town_stop_lines · town_rules · town_crossing_state · town_run · town_checks


*Provenance: drivetown.py — DRIVE operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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