osm_road_graph — DRIVE japan op

• 数据种类:table → table

• 调用: import fullseye as fs; fs.ledger.osm_road_graph(osm: 'dict', *, way_types: 'Sequence[str]' = ('motorway', 'motorway_link', 'trunk', 'trunk_link', 'primary', 'primary_link', 'secondary', 'secondary_link', 'tertiary', 'tertiary_link', 'unclassified', 'residential', 'living_street', 'service'), bbox=None, margin: 'float' = 0.0) -> 'Dict[str, object]'(要直接调用实现,import drivejapan; drivejapan.osm_road_graph(osm: 'dict', *, way_types: 'Sequence[str]' = ('motorway', 'motorway_link', 'trunk', 'trunk_link', 'primary', 'primary_link', 'secondary', 'secondary_link', 'tertiary', 'tertiary_link', 'unclassified', 'residential', 'living_street', 'service'), bbox=None, margin: 'float' = 0.0) -> 'Dict[str, object]';从台账取用则 opsdrive.get("osm_road_graph"))

用法

由 OSM 的读取结果构建道路网。

边 = way 中相邻节点对 {"a", "b", "way", "highway", "width", "lanes", "width_from", "oneway", "length", "tags"}。节点 = {"xy", "degree", "features": [NODE_FEATURES の部分集合], "tags", "edges": [辺の索引]}(仅限被边使用的节点)。传入 bbox = (xmin, xmax, ymin, ymax) 时,丢弃两端都在箱(+ margin)外的边(仅一端在外的边保留 = 道路在箱的边缘被截断)。oneway 为 "yes" / "1" / "true" 时为正向,"-1" / "reverse" 时交换 a、b 使之成为正向。Raises ValueError: way_types 中有未知种类、一条边都没有。

空输入(osm 为空 dict)会引发 ValueError。

参考(示例数据、文献)

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

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

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

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

• poc_driving_japan_town — py -3.11 examples/poc_driving_japan_town.py

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

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

同类别(japan)

osm_synthetic · osm_parse · osm_road_mask · osm_road_loops · osm_route · japan_world · japan_stats · latlon_to_local

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

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