本文へ移動
原資料を確認

MicroDuck の ONNX 書き出しと再生|入力仕様を揃える

チェックポイントを公式の書き出し処理に渡し、観測の正規化と 61 入力を保ったまま再生。旧モデルとの差、キー配置、公開パッケージの事前確認を説明します。

公式の書き出し処理は、学習時の観測正規化をモデルと一緒に扱います。チェックポイントの名前を変えるだけでは変換できません。現行の 61 観測・14 動作を、意味と順番まで合わせて再生します。

元の実験を特定する

コミット、タスク ID、設定とチェックポイントの場所を記録します。例のパスを実際のファイルへ変更し、既存の first-walk.onnx は先に退避してください。

対応するタスクで書き出す

コピーできる例
uv run scripts/export.py Mjlab-Velocity-Flat-MicroDuck \
  --checkpoint-file /absolute/path/to/model_3000.pt \
  --num-envs 1 \
  --onnx-file first-walk.onnx

公式エクスポーターが正規化も含めます。手作業で変換したモデルは、play で動いただけでは同じ内容と確認できません。

現行の命令レイアウトで再生

コピーできる例
uv run scripts/infer_policy.py \
  --walking first-walk.onnx \
  --new-cmd-obs

--new-cmd-obs は 61 入力向けです。旧 51 入力ではこのフラグを外し、元モデルとの対応を確認します。CPU 推論でも Python 依存関係、素材と表示環境は必要です。

再生できる動作を広げる前に

このコマンドが読むのは歩行モデルです。座る、キック、前転には対応するモデルが必要です。ローカルスクリプトの Y などの操作を、ブラウザの R と取り違えないでください。

公開パッケージを事前確認

コピーできる例
uv run publish --onnx first-walk.onnx \
  --repo YOUR_USERNAME/microduck-first-walk \
  --kind perpetual --slot walk --dry-run

YOUR_USERNAME を変更します。perpetual / walk は持続する歩行方策用です。--dry-run は形状、基本出力、マニフェストを確認してローカルに準備し、アップロード前に止まります。publish-first-walk フォルダーは作り直されるため、手書きメモを置かないでください。

実機へ持ち込む前の記録

開始、停止、旋回、復帰をシミュレーションで観察し、モデルと一緒に残します。出力が有限という検査だけでは実機互換を確認できません。

続ける前に確認

同じモデルを全てのロボットに使えますか?

いいえ。関節順、観測形式、動作倍率、ランタイム、付属品が一致する必要があります。実機配備前にパッケージを確認します。

対象: Pollen Robotics MicroDuck. モデル、イメージ、ソフトウェア、ドライバーの版を一緒に記録します。各日付の説明は元の検証範囲を維持します。

出典確認日:

出典と確認 (4)
  1. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/src/mjlab_microduck/export.py
  2. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/scripts/infer_policy.py
  3. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/src/mjlab_microduck/publish/cli.py
  4. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/README.md

次に読むガイド

MicroDuck学習から配備へ:準備・学習・書き出し・検証

準備、ローカル学習、書き出し、シミュレーション再生、配備確認の順に進みます。書き出しやアップロードの成功は実機での方策実行を証明しません。

MicroDuck 公式方策の選び方|スプリント・ローラー・座位

公式の四つの参照モデルをスロット、付属品、指令の意味で比較。固定版の試行と復元、内蔵正規化、学習ソース確認の限界を整理します。

MicroDuck 公式方策 v8|walk の上書きを調べて戻す手順

10 月 12 日公開の velstand v8 を固定版で確認。方策セットとデーモンを分け、手動で上書きした walk の確認・更新・単一スロット復元を案内します。