importance_risk_estimate — DRIVE traffic op

• Data kinds: any → table

• Call: import fullseye as fs; fs.ledger.importance_risk_estimate(simulate_fn: 'Callable', base_rate: 'Callable', boosted_rate: 'Callable', n_runs: 'int', seed, *, x_max: 'float', boosted_rate_max: 'float', n_grid: 'int' = 20001) -> 'Dict[str, float]' (to call the implementation directly, import drivetraffic; drivetraffic.importance_risk_estimate(simulate_fn: 'Callable', base_rate: 'Callable', boosted_rate: 'Callable', n_runs: 'int', seed, *, x_max: 'float', boosted_rate_max: 'float', n_grid: 'int' = 20001) -> 'Dict[str, float]'; from the registry, opsdrive.get("importance_risk_estimate"))

Usage

Makes accidents more likely with trials at a raised emergence rate (rate λ') and maps back to the accident probability at the original rate λ with likelihood-ratio weights.

> The detailed description below is the original text — the summary and the headings are translated.

1 回の試行 = poisson_events(boosted_rate) で出現位置 x_1..x_N を引き、simulate_fn(events, rng) が事故なら 1 (bool か [0, 1] の値)。重み(ポアソン過程の Radon–Nikodym 微分 dP_λ/dP_λ'):

w = Π_i λ(x_i)/λ'(x_i) · exp(−(Λ − Λ')), Λ = ∫λ, Λ' = ∫λ'(台形、n_grid 点)

推定 p̂ = mean(w · Y)、標準誤差 = std(w · Y)/sqrt(n)。boosted_rate を base_rate と同じにすれば w ≡ 1 で素朴なモンテカルロになる(門ではこれと、事故確率が閉形式で分かる simulate_fn とで比べる)。λ > 0 なのに λ' = 0 の所があると推定が偏る(絶対連続でない)ので格子上で検査して ValueError。

戻り値 dict: estimate, std_error, per_run_var(w·Y の標本分散)、n_runs, Lambda, Lambda_boost, mean_weight(≈ 1 のはず。重みの健全性)、ess(有効標本数 (Σw)²/Σw²)、hits(Y > 0 の回数)。

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• poc_driving_traffic — py -3.11 examples/poc_driving_traffic.py

Ops the type connects to (they accept table as input)

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

Same category (traffic)

idm_accel · idm_equilibrium_gap · idm_platoon_simulate · driver_style · lateral_wobble · ou_estimate · social_force_step · pedestrian_crossing


*Provenance: drivetraffic.py — DRIVE operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

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