コンテンツにスキップ

Operator screen

Detail 説明
— 対話端末の run・record・infer・tune-gravity はTextualを使います.起動の前に操作と起動optionを選ぶlauncherと,起動したdataflowを操作する操作画面があります.操作画面では設定の編集やoptionの切り替えは行いません.optionはdataflowの実行中には切り替えません(制御modeが変わるためです).

Launcher

Detail 説明
— roboloom(または roboloom launch)で開きます.roboloom rakuda2 のようにrobotを指定した場合は一覧を出しません.run・record・infer も,対話端末では --with・--without・--plain を指定しなければ先にlauncherを開き,commandの引数を初期値にします.

Screens

画面・欄 内容
robotの一覧 左に .roboloom/ の下で config.yaml を持つrobot(dataset名と既定で有効なoptionつき),右に選択中のrobotの設定(file,dataset名,各optionの説明・requires・競合・dataset名,既定で有効か).前回のrobotにcursorがある
Operation run・record・infer から選ぶ.record と infer ではtask・seconds・episodesを入力し,毎回初期姿勢へ動かすか(「move home before every episode」)も選べる
Options 設定の options: を help の説明付きのカードで並べる(有効は緑,競合で外れるものは黄の線と理由).チェックを入れると requires のoptionも有効になり,conflicts のoptionは外れる.外すと,それを必要とするoptionも外れる.競合の理由はtooltipに出る.infer を選ぶと,policy という名前のoptionがあれば自動で有効になる
Devices 「mock devices (no hardware)」でmock deviceを使う.「Video codec (storage: video)」で動画の codec(YAML / dataset・AV1・H.264)を選ぶ.YAML / dataset は recorder の YAML の指定(追記では保存済みの動画の codec,どちらもなければ H.264.Video codec)
要約 操作,mock か HARDWARE か(チェックを入れなくても YAML が mode: mock なら mock (mode: mock in config.yaml)),有効なoption,dataset名,動画の codec,置き換わるnode file(削除は (removed)).起動できない組み合わせや入力の不足は,理由を表示してLaunchを無効にする
sensorと方策の観測 sensor起動と方策の観測の独立したチェック欄.方策の観測の欄は,推論への切り替えなどで起動optionを変更すると,選択された policy YAML の既定値に更新される.観測を明示的に選択した後は,空の選択も含め,modeやoptionを変更しても保持する(sensor選択)
Detail 説明
--- ---
— 2つ目の画面は,左の操作panel(Operation・Devices),右のoption panel,下の要約panelに分かれます.幅が90桁未満の端末ではpanelを縦に並べます.

Keys

key・操作 動作
Enter(robotの一覧) 選んで次の画面へ進む
Esc(robotの一覧) 何も起動せずに終了する
Launch(Ctrl-S) 起動する
Cancel 何も起動せずに終了する
Back(Esc) robotの一覧から来た場合は一覧へ戻る.それ以外ではEscはCancelと同じ
境界のdrag,focusして矢印key panelの大きさを変える(操作画面と同じ)
境界のdouble-click,Ctrl-R panelの大きさを元に戻す

Saved choices

file 内容
.roboloom/logs/last_robot 選んだrobot.次回の一覧のcursorの位置
.roboloom/<robot>/logs/last_launch.yaml 操作・option・device・sensorと観測の選択.次回の初期値.観測は,YAML の既定値を使うか,明示指定かを区別して残す

Layout

領域 内容
header 機体名,mode(操作・mockか実機か・有効なoption),記録の進捗,警告
Status tab node一覧と詳細.幅100文字以上では左右に並べ,それ未満ではDetailsで選択nodeの詳細を確認する
Details tab 選択nodeの状態,項目,単位,更新からの時間.node選択は表示だけを変更し,操作はdataflow全体を対象にする
Logs tab tabを選ぶまで隠す.独立してscrollでき,非表示中の新着も保持する.過去の行を読んでいる間は新着で位置を戻さない.画面は最大10,000行を保持し,doraの全logは設定の隣の logs/ に残る
Operations すべてのtabの下に残り,表示領域の約半分を使う.対応する最小サイズ80×24でも,既定では10行以上を確保する(最小6行).使えない操作も理由付きでmenuに残る.初期focusは操作menu
境界 一覧と詳細の間の縦の境界で左右の幅,上段とOperationsの間の横の境界で上下の高さを変える(Logsや80×24でも上下の調整ができる).境界のdouble-clickで,その方向を既定サイズへ戻す.最小サイズを設け,paneと入力欄が操作できなくなるまで縮めることを防ぐ
Detail 説明
--- ---
— resizeしても選択tab・node・入力内容を保持します.幅・高さの比率はsession内で保持し,tab切り替えや端末のresize後も引き継ぎます.fileには保存しません.

Colors

表示 色
nodeの状態(一覧と詳細) 正常は緑,注意は黄,異常は赤
2秒以上更新のないnode 赤の STALE
初期姿勢の名前(詳細) magenta
記録中のtask(詳細) cyan
制限・拒否・error(詳細) 黄または赤
headerの警告,未保存(UNSAVED) 黄
Emergency stop 赤
使えない操作 薄く表示
log 記録や非常停止などの報告ごとの色を保つ

Keys

key 動作
↑ / ↓ 項目選択.入力欄では履歴
Enter 選択操作の実行,またはcommand送信
Tab / Shift-Tab 入力欄ではcommand名の補完候補を巡回.それ以外ではfocus移動
Ctrl-N / Ctrl-P pane間の移動.境界にもfocusできる
Ctrl-L command欄へ移動
Esc 補完・確認をcancel.境界のdragを解除
Ctrl-G 確認なしで非常停止を要求(確認中・drag中も使える)
Ctrl-C / Ctrl-Q 共通の終了確認を開く
Ctrl-O Logsを開いて末尾へ移動
矢印key(境界にfocus) 対応方向のサイズ調整
Ctrl-R / Home(境界にfocus) その境界を既定へ戻す
Detail 説明
--- ---
— 入力欄・確認以外では,次の文字keyで操作を要求できます.入力中とdialog中は文字keyのshortcutを抑制します.
key 操作
e estop
q quit
h home
s save
d discard
t teleop(leaderに切り替える.方策に teleop: がある構成だけ)
p policy(方策に戻す.方策に teleop: がある構成だけ)
Detail 説明
--- ---
— t・p は録画中も使え,使えないときは理由を表示します(teleopと介入).
別名 同じ動作
F2 command欄へ移動
F6 / Shift-F6 pane移動
F12 非常停止
Ctrl-End log末尾
Detail 説明
--- ---
— 画面下の案内は主要なCtrl系の組み合わせを表示します.

Command input

Detail 説明
— cursor移動,Delete,Backspace,日本語入力に対応します.
— 履歴はsession内だけで保持します.確認の回答は履歴に入りません.
— 補完だけでは操作しません.候補表示中のEnterは候補確定で,もう一度Enterを押すと送信します.
— 複数行の貼り付けは空白でつないだ1行になり,自動送信しません.

Operations

Detail 説明
— menuと入力欄から次の操作を使います.各操作の意味は runの操作 にあります.
操作 画面での扱い
start <task> run のStartはtask入力へ移動する.開始拒否は警告になり,状態更新は続くので準備後に再操作できる
stop 追従・記録を止める
save 入力欄で save success・save failure と書くと,評価の成否を付けて保存する(episodeごとの記録).success・failure 以外は拒否し,episodeは保存前のまま残る
discard episodeを破棄する
home controllerに初期姿勢がある場合だけ有効.到着後も準備状態を再確認する
release 機器の性質(脱力したときと放置したときの性質)から,支える機器と物を外す機器を示して確認する
estop 非常停止.送信失敗・送信済みだが未確認・新しいfollower状態でのESTOP確認を区別する.busやdataflowが切断されている場合の到達は保証できない
quit 終了確認を開く

Exit confirmation

Detail 説明
— 初期選択はCancelです.確認文には,終了時に脱力する(またはするかもしれない)機器と,すべきことを示します.
選択 出る条件 動作
Cancel 常に 操作画面へ戻る
followerの保持 保持できるfollowerがある(ない場合は「脱力せずに終了」) followerを保持したまま終了する
脱力して終了 torqueのあるfollowerがある 支持を確認してから脱力して終了する
Quit and choose options again (followers hold) CLIから起動した対話端末 followerを保持したまま終了し,launcherへ戻ってoptionを選び直す
Detail 説明
--- ---
— followerを保持しても,通電している入力機器は終了時に脱力します.
— UI異常終了時も,脱力の選択が確認済みでなければfollowerを保持します.
— roboloomのprocessごと止まった場合(強制終了,端末を閉じた)も,dataflowは記録中のepisodeを破棄し,followerを保持させて終わります.

record and infer

Detail 説明
— record・infer は準備状態,回数,残り時間,保存結果を表示します.
項目 動作
開始 毎回,準備後にStartを選ぶ.record --home は毎回homeへ移動する
保存 record は保存し,infer は --task がある場合だけ保存する.Stopで時間指定の記録を早く終えた場合も,同じ保存方針を適用する
回数 指定回数が完了すると終了確認が開く.回数は目安で,終了確認を閉じると,HomeやTeleopでrobotを動かし,Startで次のepisodeを続けられる(表示は episode 3 (2 planned)).--plain は指定回数で終わる
Detail 説明
--- ---
— episode中は,上部に進み具合が出ます.
— episode 2/10 step 137/500 [█████░░░░░░░░░░░░░░░] 27% at most 72.6 s left
— step は方策が実行した行動の数で,長さをstep数で決めたとき(infer --steps,実験fileの steps)に出ます.そのepisodeは,方策が指定の手数を実行した時点で終わります.秒数で決めたときは,経過時間の割合が出ます.

Gravity tuning

Detail 説明
— tune-gravity は別commandのままです(roboloom tune-gravity).同じbusを開くdataflowを先に止めます.一覧で関節を選び,Detailsで関節の説明と実測・model・送信電流(mA)を確認します.menuと入力欄で次を共用します.
— joint <name>
gain +
gain -
hold +
hold -
compare
resume
save
estop
quit
key 動作 範囲
] / [ 選んだ関節のgainを上げる・下げる 0.1刻みで[0, 3]
= / - holdを上げる・下げる 5 mA刻みで[0, 100]
0 重力の比較 —
r 支持後に通常のSTOPPEDから再開する —
Ctrl-G 次の制御処理で脱力してESTOPをlatchする.再起動までresumeでも再通電できない —
Detail 説明
--- ---
— 文字keyは入力欄・確認以外で使えます.機器open・通電・読み出し・値の変更・closeは,設定周期で動く1本の制御threadが担当します.file保存は値のsnapshotを別threadへ渡し,保存中の変更は未保存として残します.終了はCancel・Save and quit・Discard and quitから選び,初期選択はCancelです.実機での準備と値の読み方は 重力調整 を参照してください.

Plain mode and Python API

起動 動作
run --plain 行入力を維持する
record --plain・infer --plain key入力なしで指定回数を実行する
非TTY 自動でこれらの経路を選ぶ
tune-gravity(非TTY) deviceを開く前に拒否する
Detail 説明
--- ---
— Session.launch(..., screen="auto") は約10 HzのRich状態表示を維持します.stdinを読まないので,print()・input() と既存の操作者向け終了確認を引き続き使えます.screen=False で表示,operator=None で操作者への確認を無効にします.CLIのTextual Backendは両方を指定し,画面内で確認します.Session も参照してください.

Extending the display

Detail 説明
— 通常の拡張は,既存のfollower・input・sensor・controller登録と状態通知を使います.StatusReporter で標準のrole・level・timestamp・fieldsを通知し,項目名には単位を含めます.共通画面は関節数・名前・ID・単位を固定しません.未知の役割・項目も汎用key/valueで表示します.
— 専用表示が必要な場合だけ,起動前にPresenterを明示登録します.機種(node YAMLの type),役割Presenter,既存の ui.render.RENDERERS の役割表示,汎用表示の順に選びます.Presenterは NodeSnapshot を受け取り Presentation を返し,Widgetやdeviceを扱いません.
— register_presenter(kind="my_stage") / register_presenter(role="my_role"): NodeSnapshot → Presentation(state, detail, fields)
— 役割別には role="my_role" を指定します.Backendは型付きの Snapshot / Capabilities / Operation を渡し,ui.models.Backend の契約で操作要求を受け取ります.Operationに利用可否・理由・確認条件をまとめ,menuと入力欄が共用します.Backendと機器実装はTextual Widgetに依存しません.拡張は明示的なPython登録に限り,外部pluginの自動探索や新しい設定形式はありません.
— thread通知は Textualのmessage を使います.testはfake Backend・MockBusと run_test / Pilot を使います.mock成功は実機の停止時間や収集品質を保証しません.

Hook status

Field Unit 意味
hook_ms Mock only ms 直近の周期の step hook の合計時間
hook_max_ms Mock only ms この episode の合計時間の最大値
hook_errors Mock only count on_error で処理した step error と barrier failure の数
hook_over Mock only count measured budget を超えた hook call の数
filtered Mock only periods この episode で chain が変更した周期数(policy と teleop)