コンテンツにスキップ

しくみ

roboloomを使う前に知っておくと読みやすくなる,node,設定,単位,Session,episodeの状態をまとめます.keyの一覧は 設定 にあります.

node

1つの構成は,役割ごとのnodeの集まりです.各nodeはdora-rsのdataflowの中で別のprocessとして動き,設定を自分で読みます.

役割(config.yaml のkey) 何をするか 例
inputs 人が動かす機器を読む Rakuda-mini(leader),Pika Sense
controllers 入力か方策を,followerの目標に変える joint,policy,pose_ik
followers 目標を受けてmotorを動かし,状態を返す Rakuda2,PiPER,Pika Gripper
sensors 観測を取得する RealSense,DIGIT,音声
recorder 全nodeの出力を記録の行にそろえて保存する LeRobotDataset
session 操作(start,stop,save …)を受けて各nodeへ配る 操作画面,roboloom session
trackers,estimators 姿勢の追跡,外力の推定 Lighthouse,effort
flowchart LR
  subgraph flow["dora dataflow"]
    I["inputs"] --> C["controllers"]
    C --> F["followers"]
    F --> C
    X["sensors"] --> R["recorder"]
    F --> R
    I --> R
    N["session"] -.-> C
    N -.-> R
  end
  S["Session<br/>操作画面・CLI・Python"] --> N
  R --> D[("LeRobotDataset")]

設定の合成

機体ごとに .roboloom/<robot>/config.yaml が1つあります.nodeごとの設定は nodes/ のfileに分かれ,起動時に次の順で1つの設定にまとまります.

flowchart TB
  A["config.yaml<br/>役割ごとのnode file"] --> B["起動option<br/>--with で set: を当てる"]
  B --> C["extends<br/>土台のnode fileに重ねる"]
  C --> D["実験file<br/>configs/roboloom/名前.yaml"]
  D --> E["読み込んだ設定"]
  M["mock.yaml<br/>--mock のときの SET_ の値"] -.-> E
仕組み 何をするか 詳しく
起動option(options) node fileを置き換え・足し・外す.記録が変わるならdataset名に接尾辞を付ける 起動option
extends 土台のnode fileに,違うところだけを重ねる extends
実験file 方策,option,保存先,task,長さを1つにまとめる 実験file
mock.yaml 模擬のdeviceのときだけ,SET_... の代わりの値を与える 未設定の値と模擬

単位

  • 関節の位置の単位は,followerと入力が宣言します.Rakuda2とRakuda-miniはDynamixelの生の位置count(dynamixel_count),PiPERはradです.
  • 指令にも単位が入り,followerは自分の単位と違う指令を受け取りません.
  • max_speed と home.tolerance は,どこに書いてもfollowerの単位(/s)です.
  • datasetの observation.state と action は,followerの単位のまま記録します.方策も同じ単位で目標を返します.

詳しくは 単位 にあります.

Session

Session はdataflowを起動し,episodeの操作を送るPythonのclassです.CLIと操作画面はこれを呼ぶ薄い層です.

入口 例
操作画面 uv run roboloom run
別の端末 uv run roboloom session save
Python Session.launch("rakuda2", options=["gravity"])

APIは Session,操作は runの操作 にあります.

episodeの状態

recorderのepisodeは次のように進みます.操作画面のrecorderの行に,今の状態が出ます.

stateDiagram-v2
  [*] --> idle
  idle --> recording: start
  recording --> stopped: stop
  stopped --> saving: save
  saving --> idle: 保存した
  stopped --> idle: discard
  recording --> idle: discard
  • stopped の間は,save か discard を選ぶまで次の start を拒否します.saving の間も拒否します.
  • stop はfollowerを保持します.脱力はしません.

leaderで動かす joint controllerは,episodeとは別に次の状態を持ちます.aligning の間は start を拒否します.

stateDiagram-v2
  [*] --> waiting_input
  waiting_input --> aligning: 差が許容差を超える
  waiting_input --> following: 差が許容差の内
  aligning --> following: 差が許容差の内
  following --> input_stale: 入力が途絶えた
  input_stale --> aligning: 入力が戻った
  following --> follower_fault: FAULT・ESTOP
  follower_fault --> aligning: 復帰のあと
  • aligning の間は,関節の差(worst_joint,worst_diff)が画面に出ます.leaderをfollowerに揃えます.
  • 方策のcontrollerは loading → ready → running と進み,stop で ready に戻ります(方策が失敗したとき).