long_simulate — DRIVE long op

• 数据种类:scalar × scalar × any → table

• 调用: import fullseye as fs; fs.ledger.long_simulate(s0: 'float', v0: 'float', command: 'Callable', road=None, t_end: 'float' = 30.0, dt: 'float' = 0.01, params: 'Optional[dict]' = None, t_breaks: 'Sequence[float]' = (), t0: 'float' = 0.0) -> 'Dict[str, object]'(要直接调用实现,import drivelong; drivelong.long_simulate(s0: 'float', v0: 'float', command: 'Callable', road=None, t_end: 'float' = 30.0, dt: 'float' = 0.01, params: 'Optional[dict]' = None, t_breaks: 'Sequence[float]' = (), t0: 'float' = 0.0) -> 'Dict[str, object]';从台账取用则 opsdrive.get("long_simulate"))

用法

用 RK4 积分纵向运动方程(在事件时刻切分步长;见模块的 docstring)。

> 以下的详细说明为原文 —— 摘要与标题已翻译。

Parameters

s0, v0 : 初めの位置 [m] (道なりの弧長)と速度 [m/s] (負 = 後ろ向き)

command : command(t, s, v) -> (drive, brake)(どちらも ≥ 0 [m/s²]。上限は μ g cos θ と a_max で頭打ち)。

v = 0.0 で呼ばれるのは止まっている間だけ(動いている刻みの中間点で速度が 0 を横切っても、指令には動きの向きの

±1e-300 を渡す)ので、指令は v == 0 / v <= 0 で「止まったら保持」を書いてよい。

指令が時刻で不連続に変わるなら、その時刻を t_breaks に入れると刻みがそこで切れる(厳密さのため)。

road : 道の縦断(road_eval と同じ)

t_end : 終わりの時刻 [s]、dt : 刻み [s]

params : long_params の dict(None = 既定)

t0 : 初めの時刻 [s]

Returns

dict : t, s, v, a, drive, brake, z, W_drive, W_brake, W_rr, W_drag(各 (n,) の配列、a = その時点の加速度)、

stopped(bool 配列)、events(("stop"|"move", t, s, 向き) の列)、saturated(上限で頭打ちになった刻みがあったか)、params。

Raises ValueError: 引数が不正、指令が負や非有限を返した。

参考(示例数据、文献)

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

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

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

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

• poc_driving_longitudinal — py -3.11 examples/poc_driving_longitudinal.py

• poc_driving_town — py -3.11 examples/poc_driving_town.py

• poc_driving_traffic — py -3.11 examples/poc_driving_traffic.py

• poc_driving_weather — py -3.11 examples/poc_driving_weather.py

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

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

同类别(long)

long_params · road_profile · road_eval · long_energy_residual · stopping_distance_grade · stop_line_plan · plan_command · hill_hold_brake_min


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

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