カテゴリー
お知らせ

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

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


v12.0.0

学習 API RC_read をライブラリの側で一律に打ち切る仕様をやめ、どこまでの値を信じるか (上限) をプログラムが RC_setReadLimit で決めるようにしました (Stage BQ・走行物理と測距は無改変です — 出荷の見本で走らせたときの走りと、出荷の公式サンプル大会の結果は変わりません。出荷の見本 3 言語と Python の車種別 3 本は、完走が定義される卓上 56 コースすべてで verifyHash が v11.1.0 と同じです。公式サンプル大会の verifyHash e9f1da0b と凍結ハッシュ f0〜f3 も改修前と同じで、結果ファイルの resultSha256 だけが版 (engineVer) を含むため再ピンしました)。実機のライブラリ (Arduino RumiCar-lib v0.7.0・Raspberry Pi の RasPi/RumiCar.py 0.7.0・RumiCar-Zero2Cam v0.7.0) と同じ名前・同じ意味です。あなたのプログラムの動きが変わることがあります — RC_read を使い、RC_setReadLimit を呼ばないプログラムは、卓上と中スケールで、これまで -3 だった距離を数値で受け取ります。① RC_read の既定 — v11.x は、卓上で 200 mm (中スケールは 400 mm) を超える測距を -3 にしていました。v12.0.0 からは測距レンジ (卓上 2,000 mm・中スケール 4,000 mm) までの値をそのまま返します。-3 になるのは、測距レンジを超える・反射するものが無い・低信号のときと、プログラムが決めた上限を超えたときです。フルスケールは以前から打ち切りが無く、変わりません (センサーノイズを ON にしたときだけ、ノイズで測距レンジを少し超えた値も -3 になります。実機のライブラリと同じ判定の順です)。v11.x と同じ値を受け取るには、setup() の RC_setup() の次の行に RC_setReadLimit(200) を足します (卓上。中スケールで v11.x と同じにするなら 400)。② RC_setReadLimit(上限)/RC_setReadLimit(方向, 上限) — RC_read の値を信じる距離の上限 [mm] を決めます (setup() で 1 回呼ぶ)。引数 1 個は前・左・右・後ろのすべて、2 個はその方向 (LEFT/CENTER/RIGHT/REAR) だけです。上限は 1〜測距レンジ (卓上は実機と同じ 2000)、0 は上限なし (既定) で、範囲外の値は 0〜測距レンジに収め、小数は 0 方向へ切り捨てます。上限を超える値は RC_read が -3 を返します (上限ちょうどの値は距離のまま・-1 と -2 は変わりません)。戻り値は 1、方向が不正なら 0 を返して何も変えません。数にできない値 (数字以外の文字列・None・list) は上限なしとして扱い、同じ値につき 1 回だけ警告します。REAR は後方センサーが無くても設定でき、RC_read(REAR) は -1 のままです。RC_setup は上限を変えません。上限は走行 (▶・🏁) を始めるたびに上限なしへ戻ります。引数は 1 個か 2 個で、違う数の呼び出しは C++ と Python では行番号付きの実行時エラーです (JavaScript は、引数が無ければ上限なしとして警告し、3 個目からは無視します)。生読取 sensorN.readRangeSingleMillimeters() (C++・JavaScript) と画面の距離表示は上限の影響を受けません。上限はプログラムに書いた mm のままで、領域ではスケールしません。③ -3 の置き換え — -3 を 999 に置き換えてから左右を比べる書き方 (if d == -3: d = 999) は、上限を決めないと 1000 mm 以上の距離が「-3 より近い」ことになり、逆へ切ります。「RC_read が返すどの距離よりも大きい値」(卓上は 9999 など) に置き換えるか、RC_setReadLimit で上限を決めてください。④ 出荷の見本と説明 — 見本 (Wall Hugger・C++/Python/JavaScript) と Python の車種別 3 本 (Wall Hugger/4WD/FF) は setup() で RC_setReadLimit(200) を呼び、-3 の置き換え値を 999 から 9999 にしました (卓上の走りは v11.1.0 と同じ)。フルスケール用の競技プログラム 9 本 (Circuit Racer・Range-Flow Estimator・Recon Racer ほか) は RC_read を使いますが、上限を決めていません (フルスケールは以前から打ち切りが無いので、フルスケールでの走りは変わりません)。説明 (使い方・仕様と制限・物理モデル・システム説明・車種別プログラムの説明) は上限を「RC_setReadLimit で決めた上限」と名前で参照します。推奨値の例・その根拠・値の決め方は、物理モデル解説 docs/physics_model.md §12 の「上限の決め方」の 1 か所にだけ書きました。上限を変えるときに直すのは、プログラムの 1 行とその項だけです。⑤ なぜ変えたか — 実機の ToF はレーザーがコーン状に広がり、取り付け位置によっては、ある距離から先で床を拾います。その距離は車体・取り付け位置・床で変わるので、ライブラリが一律に決めるのをやめ、プログラムが決める形にしました (実機のライブラリ v0.7.0 と同じ決定です)。本シムの測距には床の映り込みが無いので、上限を広げたプログラムが本シムで走っても、実機で同じに走る保証にはなりません。⑥ 検証 — 正本の RasPi/RumiCar.py 0.7.0 を実行して作った表 (RC_setReadLimit の呼び出しの列 105 通り〔C++ の処理系は、C++ で書ける 83 通り〕× 生の値 15 通り × 3 方向) と、ホストの関数・C++・Python・JavaScript の処理系の戻り値・警告の数・設定後の RC_read が一致します (検証ゲート wf_bo1_steer の G 章。壁を置いて本番の測距に測らせます)。RumiCar-lib v0.7.0 の Exercise-3.3・4.2-Answer、RasPi の Exercise-3.1〜3.3、Zero2Cam v0.7.0 の見本 drive.py は本文を変えずに処理系を通ります (drive.py は params.json が無いので、従来どおり loop() の p["stop_mm"] で止まります)。wf_bh6_docs の D 章が、見本の verifyHash が v11.1.0 と同じこと・説明に上限の数値が残っていないことを見ます。常設ゲートは 82 本のまま、実ブラウザの検査に browser/check_bq1_readlimit.mjs を足しました。変えていないこと: 走行物理・測距そのもの (センサーのレンジ・扇の描画・ノイズ/光学モデル)・生読取の値・フルスケールの RC_read (① のセンサーノイズ ON の場合を除く)・RC_steer/RC_drive の値と警告・公式レース (🏁) の決定論エンジン・保存データの形式・卓上コース。v11.x 以前の版で確定した公式レースの記録は、従来どおり別の版の記録として扱います (RC_read を使い上限を決めないプログラムは、v12.0.0 で走らせ直すと結果が変わることがあります)。

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

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

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