しくみ
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に戻ります(方策が失敗したとき).