カテゴリー
お知らせ

RumiCar シミュレータ v12.1.0 を公開しました

RumiCar シミュレータ v12.1.0 を公開しました。リリースノートは GitHub でも読めます。


v12.1.0

出荷の見本と説明を、RC_read の値を「距離」と「ステータス」に分けて扱う書き方にそろえました (Stage BR・走行物理・測距・学習 API・処理系は無改変です — 出荷の見本で走らせたときの走りと、出荷の公式サンプル大会の結果は変わりません。出荷の見本 3 言語と Python の車種別 3 本は、完走が定義される卓上 56 コースすべてで verifyHash が v12.0.0 (=v11.1.0) と同じです。公式サンプル大会の verifyHash e9f1da0b と凍結ハッシュ f0〜f3 も改修前と同じで、結果ファイルの resultSha256 だけが版 (engineVer) を含むため再ピンしました)。実機の見本 (Arduino RumiCar-lib v0.7.1 のスケッチ例・Raspberry Pi の RasPi/Exercise-3.1〜3.3) と同じ決まりです。あなたのプログラムの動きは変わりません — 変えたのは、出荷の見本の本文と説明だけです。① 値を扱う順序 — RC_read の値は、まず 0 以上 (距離) か負の数 (ステータス) かで分け、ステータスの処理を loop() の最初の 1 つのブロックにまとめます。-1 (センサーが応答しない) は RC_drive(BRAKE, 0) で止まり、その回は判断しません。-3 (範囲外) は「その方向の上限より手前に測れた物が無い」というステータスで、走っていればふつうに起きます。「遠い」とみなすのはプログラムの決めごとです。比べるときは先頭の定数 FAR_MM (9999) に置き換え、FAR_MM は大小の比較にだけ使います (左右の差は、左右とも距離のときだけ計算します)。② 上限は先頭の定数 LIMIT_MM — 上限の数値は先頭の定数 LIMIT_MM に書き、setup() で RC_setReadLimit(LIMIT_MM) と呼びます (v12.0.0 の見本は setup() の行に数を直接書いていました)。距離のしきい値は LIMIT_MM 以下にします。③ 出力 — 見本 (C++・Python・JavaScript) のシリアル出力は、RC_read が返した値のままにしました。-3 がそのまま見えます (v12.0.0 の見本は、-3 を置き換えた値 9999 を出力していました)。④ 本シムの前・左・右は -1 を返しません — 実機のライブラリは、センサーのタイムアウトで -1 を返します。本シムの前・左・右のセンサーは -1 を返しません (センサーノイズを ON にしたときの欠測も -3 です。以前の版から同じです)。-1 が返るのは、後方センサーを付けていない車の RC_read(REAR) だけです。見本の「-1 で止まる」分岐は、同じプログラムを実機で動かすためのもので、本シムの走行では実行されません。v12.0.0 までの見本は、-1 を置き換えずに比較へ入れていました (実機でタイムアウトが起きると「近い」と判断して後退する書き方でした)。⑤ 説明 — アプリ内の説明 (使い方 7 章・仕様と制限・システム説明・物理モデル・車種別プログラムの説明) と、物理モデル解説 docs/physics_model.md §12 を、この順序・LIMIT_MM・FAR_MM に合わせました。物理モデル解説には、C++ での引数の読み方が実機と違う点を書き足しました。本シムの C++ は、学習 API の引数を Python と同じ規則で読みます。方向に小数や true を渡すと不正な方向として扱い (RC_read は -2、RC_steer・RC_drive・RC_setReadLimit は 0 を返して何もしない)、数字だけの文字列の強さ・速さ・上限は数として読みます。実機の Arduino は、小数や true を整数に変換して使います (0.5 は LEFT、true は CENTER)。方向を定数で、値を整数で書くふつうのプログラムでは、違いは出ません (v12.0.0 の照合で見つかった違いで、処理系は直していません)。⑥ 書き方を変えていない見本 — C 版の車種別プログラム (Apex Hunter ほか) は、生の値と信頼区間 CONF を使う従来の書き方のままです。フルスケール用の競技プログラム 9 本 (Circuit Racer・Range-Flow Estimator・Recon Racer ほか) は、負の数と CONF を超える値をまとめて大きな値に置き換える従来の書き方のままです (フルスケール専用で、実機へ移すプログラムではありません)。⑦ 検証 — 見本 6 本の verifyHash (卓上 56 コース・本番の runRace) は v12.0.0 と同じです。▶ と同じ流れで、センサーノイズ OFF と ON の両方で走らせても、新旧の見本で車の状態 (位置・向き・舵・駆動) は走行の最初から最後まで一致し、前・左・右の RC_read に -1 は 1 回も出ません (卓上 6 コース・各 60 秒)。-1 で止まる分岐は、実機のライブラリ (RasPi/RumiCar.py 0.7.0 と、RumiCar-lib v0.7.1 の RumiCar.cpp) の上で、タイムアウトを含む入力を与えて確かめました (タイムアウトの無い入力では、旧い見本と指令が全回一致します。タイムアウトの回は、新しい見本がブレーキだけを出します)。検証ゲート wf_bh6_docs の D 章は、RC_read だけを入力の列に差し替えた処理系で、-1 の回は RC_drive(BRAKE, 0) だけを出して状態を変えないこと、3 言語の見本の指令が全回一致すること、説明に書いた「前・左・右は -1 を返さない」「C++ での引数の読み方」が実測と合うことを見ます。RumiCar-lib v0.7.1 の Exercise-3.3・4.2-Answer と、RasPi の Exercise-3.1〜3.3 (公開済みの現行版) は、本文を変えずに処理系を通ります (wf_bo1_steer の D 章の本文を現行版に替えました)。常設ゲートは 82 本のまま、実ブラウザの検査に browser/check_br1_values.mjs を足しました。変えていないこと: 走行物理・測距そのもの・学習 API (RC_read・RC_setReadLimit ほかの戻り値と警告)・C++/Python/JavaScript の処理系・公式レース (🏁) の決定論エンジン・保存データの形式・卓上コース。

このサイトの仕組み (v1.6.0)

一部は GitHub で公開しています:

この仕組みを面白いと思った方へ — 本丸は、ブラウザで動く自動運転シミュレータです。
シミュレータを試す → / GitHub →