カテゴリー
お知らせ

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

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


v11.0.0

学習 API を実機の RumiCar ライブラリ (Arduino RumiCar-lib・Raspberry Pi RasPi/RumiCar.py・RumiCar-Zero2Cam) と同じ名前・同じ値に統一し、RC_steer の強さ (第2引数) と loop() の途中の delay に対応しました (Stage BN・BO。走行物理は RC_steer に強さ 1〜254 を渡したときの舵の動きだけを変えました (強さを省いた呼び出しと 255 は従来と同じ式)。学習 API RC_read の値・Python の名前・RC_steer の第2引数・loop() の途中の delay の動きが変わる改修なので MAJOR です — 卓上で RC_read を使うプログラムや、強さ・途中の delay を使うプログラムの走りは変わります。公式サンプル大会 (フルスケール・RC_read は打ち切り無し) の走りは同じで、verifyHash e9f1da0b と凍結ハッシュ f0〜f3 は改修前と同じです。結果ファイルの resultSha256 だけが版 (engineVer) を含むため再ピンしました)。① RC_read の 20 cm 打ち切り — 実機のライブラリは ToF の測距を 200 mm で打ち切り、それより先に何も無ければ -3 を返します (0〜200 = 距離 mm・-1 = 読めない・-2 = 引数エラー・-3 = 20 cm 以内に何もない=開けている)。シミュレータの RC_read(LEFT/CENTER/RIGHT/REAR) も同じ値を返します: 卓上は 200 mm で打ち切り (実機の模型と同じ条件で学ぶ)・中スケールは長さ相似で 400 mm (sensorMaxMm と同じ扱い)・フルスケール (実車サイズ) は打ち切り無し (実車は ToF の搭載位置が高く地面を捉えないため現状のレンジのまま)。打ち切るのは RC_read だけで、測距そのもの (レンジ 2,000 mm・扇の描画・ノイズ/光学モデル) と C++/JavaScript の生読取 sensorN.readRangeSingleMillimeters() (Arduino の教材と同じ) は変えていません。-3 は数としては最も小さいので、見本は比較の前に if d == -3: d = 999 と「遠い」へ置き換えます。② 名前の統一 — 後方センサーの BACK を廃止し REAR (=3・Arduino と同じ値) に。後方センサー未装備の RC_read(REAR) は -1 (従来 -2)。車輪エンコーダの軸も RC_wheel_speed(FRONT=0 / REAR=3) (従来の REAR=1 は Arduino の値と衝突していました。FRONT/REAR 以外は -2)。Python に見せる名前を正本と同じものに絞りました: RC_setup/RC_steer/RC_drive/RC_read と定数、任意装備の RC_wheel_speed、Python 標準の print・time・math・random・sys。Raspberry Pi 系の旧い別名 rc_steer/rc_drive/rc_clear/rc_wheel_speed・read_one_sensor()・read_all_sensors()・sensorN.get_distance() と、Arduino 固有の Serial・delay・millis・micros・map・constrain・sensorN は Python から外しました (C++/JavaScript は Arduino と同じまま)。RasPi の RumiCar.py と Zero2Cam にある RC_params() (params.json の値。シミュレータでは空の dict) と RC_state("名前") (処理状態の名前。変わったときに state A -> B を出力) を Python に追加 (C/JS の名前は Arduino と同じまま)。from RumiCar import * と import RumiCar (→ RumiCar.RC_drive(...)) のどちらの書き方でも動き、RasPi の形 (最上位の while True:) と Zero2Cam の形 (def setup()/def loop()) のどちらでも動きます。RumiCar リポジトリの RasPi の Exercise 1.1〜3.2 (import sys; sys.path.append('..') を含む) と Zero2Cam の見本 drive.py が、本文を変えずに処理系を通ることを確認しました (drive.py は RC_params()["stop_mm"] が空の dict に無い鍵なので、下の ④ の KeyError で止まります=実機と同じ失敗の仕方)。③ 見本プログラムの作り直し — 卓上コースの通路 (0.4〜0.9 m) は 20 cm より広いので、真ん中を走ると左右の ToF は -3 ばかりになります。出荷の見本 (samples.js・C/Python/JavaScript) と Python の車種別プログラム 3 本を右の壁に寄って沿う「Wall Hugger」へ書き直しました: 右の壁との距離を一定の帯に保ち、前方 20 cm 以内に壁が見えたら左右で開いている方へ切り、右の壁を見失ったら右へ切って探し (長く見えないときは半分の時間だけ切って大回り)、前が 80 mm まで詰まったら逆ハンで後退して切り返す。両側が見える狭い通路では左右の差で真ん中へ。実測 (完走が定義される卓上 56 コース・ソロ・laps=3・rejoin=OFF・本番 runRace): Wall Hugger FR 50/56・4WD 53/56・FF 48/56 (旧 Python 版 Apex Hunter 系は打ち切り前で 46/42/38・C 版は 47/48/47)。4WD/FF 版は「曲げるときはアクセルを 70 まで抜く」「切り始めたら 2 回は切り続ける (HOLD)」を足しています (旋回半径はアクセルで変わる: PWM 200 で走ってから全舵で切り、その PWM へ切り替えたときの実測で、240 → 70 で FR 0.8→0.45 m・4WD 1.3→0.7 m・FF 1.8→0.8 m)。見本 3 言語は 56 コースすべてで verifyHash が一致 (処理系の等価性の機械確認)。C 版の車種別プログラム (Apex Hunter ほか) は生読取と信頼区間 CONF を使う従来の書き方のまま走りも同じです (ドリフト 3 本の後方センサーは RC_read(BACK) → 生読取 sensor3.readRangeSingleMillimeters() で判定 0 ≤ B < 650 の意味を保ち、後方センサー ON の 2 台走行の verifyHash が改修前と一致。Range-Flow Estimator は RC_read(REAR)。Python の競技プログラム 3 本は Serial.println → print)。④ 処理系 — Python の dict に無い鍵の読み取り (d["x"]) を行番号付きの実行時エラー (KeyError 相当) にしました (従来は値なしで黙って続いた)。dict の表示 (print(d)・str(d)・f-string) を python3 と同じ {'a': 1} の形にしました (従来は [object Object] か JS のエラー。list の表示 1,2 は従来どおり)。Python の time.time()/time.monotonic() のビジーウェイトにも、millis() と同じ無限ループのヒントを出します。⑤ 説明と検証 — 使い方 7 章・仕様と制限・設計Q&A・物理モデル解説 §12 (ja/en) を新しい API に合わせ、§12 に打ち切りと Wall Hugger の節を追加。検証ゲート: wf_bh6_docs の D 章を「Python 版 3 本と C 版 3 本の完走数・見本 3 言語の一致・g ≈ 18 + 0.976·R の定数」を本番 runRace と config で実測照合する形に差し替え、wf_bj1_pysem の出荷見本の AST 指紋を新しい本文で刻み直し、wf_bj1/wf_as12 のフィクスチャの rc_* を RC_* に。RumiCar リポジトリの programs/ も gen_program_files.mjs で再生成しました (Python 版は .py・Zero2Cam の形)。⑥ RC_steer の強さ (Stage BO) — 実機のライブラリ (RumiCar-lib v0.6.0・RasPi RumiCar.py 0.6.0) と同じく RC_steer(方向, 強さ) の第2引数 (操舵モーターへの信号の割合 0〜255・補正なし) を既定の車でも受け付けます (v10.5.0 までは任意装備の連続舵の車だけで、既定の車では 0 を返して舵を変えませんでした)。0 は CENTER と同じ (中立)、255 と省略は従来と同じ全舵 (軌跡も 1 ビットも変わりません)、CENTER では強さを無視します。既定の車 (DC モーター) は目標舵角を全舵×強さ/255 にし、中央から外へ切る速さも強さ/255 倍にします (中央へ戻る向きは従来の速さ)。任意装備の連続舵 (比例サーボ) は舵の速さが強さに依らず一定です。値は相対的な目安で、車種による補正はしていません (物理モデル解説 §12「学習 API RC_steer の強さ」)。⑦ 引数の扱いを正本に合わせました — RC_steer・RC_drive の強さ・速さは 0 方向へ切り捨てて 0〜255 に収めます (Python の int()・Arduino の int 引数と同じ。v10.5.0 までは四捨五入で RC_drive(FORWARD, 99.9) は 100、いまは 99)。数にできない値 (数字以外の文字列・None・list・省略) は 0 とし、方向の誤り・RC_state の不正な名前とあわせて、最初の 1 回だけログに警告します (同じ関数・同じ値の警告は 1 回)。出荷のプログラムで小数の速さを渡していた Launch Lab・Brake Lab・Apex Strategist には四捨五入 ((int)(… + 0.5)・int(pwm+0.5)) を書き足し、走りは改修前と同じです (traceHash・verifyHash が一致)。⑧ loop() の途中の delay — loop() の本体の直下に書いた delay(ms) (C)・time.sleep(秒) (Python) は、実機と同じくその場で待ってから続きの文を実行します (その回の loop() をそこで区切り、同じローカル変数のまま続ける。while True: の本体も同じ。区切った後は周期 0.05 秒を足さず待ちの分だけ後に続きを呼ぶ)。v10.5.0 までは途中の delay でも待たずに後ろの文を実行したので、RC_steer(RIGHT); delay(500); RC_steer(LEFT); delay(500); (Exercise-2.1・2.2・2.4・2.5 の形) は最後の指令しか効きませんでした。本体の最後の delay、if/for の中・自作の関数の中・式の一部の delay、JavaScript の delay は従来どおりです。出荷の見本プログラムは delay を使っていないので走りは変わりません。⑨ Exercise-2.5・3.3 — RumiCar-lib v0.6.0 の Exercise-2.5「ハンドルの強さを変えてみよう」・3.3「なめらかに走る車」と RasPi 版 (python3 RumiCar.py で動く setup()/loop() の形) が、本文を変えずに動くことを本番の画面 (⬆ で読み込んで ▶) と本番 runRace で確かめました (2.5 は 0.5 秒ごとに RIGHT255→LEFT255→RIGHT128→LEFT128・3.3 は楕円のオーバルコース 3 周を完走)。本シムの C の / は真の除算のままなので、3.3 の C 版のシリアル出力の Power は小数になり、1.3 倍を続けたときの強さは Arduino より少しずつ大きくなります (Python 版は // で Arduino と同じ)。RumiCar リポジトリの programs/ の README の「RasPi で動かすときは末尾に setup() と while True: loop() を書き足す」を、python3 RumiCar.py でそのまま動く旨に直しました。検証ゲートに wf_bo1_steer (正本 RasPi RumiCar.py 0.6.0 を実行して作った表との照合 RC_steer 240・RC_drive 90・RC_state 12 通り・操舵の法則・delay の区切り・Exercise-2.5/3.3) を足して常設ゲートは 82 本に、実ブラウザの検査に check_bo1_exercise を足しました。変えていないこと: 走行物理 (⑥ の強さ 1〜254 の舵を除く)・測距そのもの (sensors.js)・生読取の値・C/JavaScript の名前・公式レース (🏁) の決定論エンジン・保存データの形式・卓上コース。

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

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

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