CLI リファレンス
pmokeの全featureを対象とする、commandとoptionの自動生成リファレンス。
型付きclap metadataから自動生成。手動編集は上書き対象。
コマンド索引
| コマンド | 説明 | 必要なfeature |
|---|---|---|
pmoke show | 設定ファイルの内容表示 | core |
pmoke monitor | 設定・解析artifactのライブ端末ダッシュボード | core |
pmoke config | 設定ファイルの確認・移行 | core |
pmoke raw | 保存済みRAW波形の確認・検証 | core |
pmoke instruments | 対応装置とhardware capabilityの確認 | core |
pmoke bench | 装置transportのリクエスト遅延benchmark | core |
pmoke export | 保存データの交換形式export | core |
pmoke doctor | 設定、ストレージ、Python、接続装置の診断 | core |
pmoke single | オシロスコープのsingle mode設定 | hw-core |
pmoke trigger | ファンクションジェネレータからのtrigger送信 | hw-core |
pmoke autoshot | single mode設定とtrigger送信 | hw-core |
pmoke fetch | オシロスコープデータの取得・保存 | hw-core |
pmoke screenshot | オシロスコープ画面のPC直接取得 | hw-core |
pmoke automeasure | single mode・trigger・fetchの自動測定 | hw-core |
pmoke reference | 記録したEOM駆動正弦波をフィッティング | core |
pmoke sensor | センサー信号解析 | core |
pmoke li | 数値lock-in解析 | core |
pmoke signal | lock-in窓での生信号channel平均 | core |
pmoke phase | lock-in解析の参照位相回転 | core |
pmoke moke | Kerr角度を計算 | core |
pmoke analyze | sensor・reference・signal・lock-in・phase・mokeの全解析 | core |
pmoke compare-lockin | 共有データ・固定window gridでのlock-in推定器比較(結果を新規directoryへ) | core |
pmoke evaluate-lockin | 凍結protocolによるpaired lock-in baseline・candidate値の評価とJSON report出力 | core |
pmoke calibrate | 記録済みデータからの較正artifactのbuild・inspect・validate | core |
pmoke noise | 記録済みデータのパルスノイズ診断・比較・再実行 | core |
pmoke process | 手動pulse trigger後のfetch・lock-in・phase・moke自動解析 | hw-core |
pmoke auto | 完全自動測定・解析 | hw-core |
pmoke completions | shell completion scriptの生成 | core |
グローバル option
| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-c, --config <FILE> | - | config.toml | 設定ファイルpath。既定値./config.toml。 | - |
--run-dir <DIR> | - | - | run artifactを保存・読み込むdirectory | - |
-f, --force | - | - | 既存run artifactの上書き許可 | - |
-h, --help | - | - | help表示 | - |
-V, --version | - | - | version表示 | - |
pmoke show
設定ファイルの内容表示
pmoke show [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke monitor
設定・解析artifactのライブ端末ダッシュボード
pmoke monitor [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke config
設定ファイルの確認・移行
pmoke config [-h, --help] <COMMAND>| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke config init
初期設定ファイルの生成
pmoke config init [--output <FILE>] [-f, --force] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--output <FILE> | - | - | --configの代わりにFILEへtemplate出力。標準出力は'-'。 | - |
-f, --force | - | - | 既存出力ファイルの上書き許可 | - |
-h, --help | - | - | help表示 | - |
pmoke config validate
解析を伴わない設定ファイル検証
pmoke config validate [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke config explain
設定section・fieldの説明
pmoke config explain [<PATH>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
<PATH> | - | - | 説明対象fieldまたはsection path。例: lockin.filter。 | - |
-h, --help | - | - | help表示 | - |
pmoke config migrate
設定の最新実行可能schemaへの移行
pmoke config migrate [--output <FILE>] [--in-place] [--check] [--accept-lossy] [--to <VERSION>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--output <FILE> | - | - | 移行済みTOMLのFILE出力。標準出力は'-'。 | check, in_place |
--in-place | - | - | version付きbackup作成後の設定原本のatomic置換 | check, output |
--check | - | - | 移行要否のみの報告 | in_place, output |
--accept-lossy | - | - | legacy動作を変更し得る移行stepの許可 | - |
--to <VERSION> | - | - | 最新実行可能版に代わる移行先versionの固定 | - |
-h, --help | - | - | help表示 | - |
pmoke raw
保存済みRAW波形の確認・検証
pmoke raw [-h, --help] <COMMAND>| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke raw verify
RAW metadata・file size・checksumの検証
pmoke raw verify [--input <DIR>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--input <DIR> | - | - | RAW取得directory。既定値acquisition/、legacy fallbackあり。 | - |
-h, --help | - | - | help表示 | - |
pmoke instruments
対応装置とhardware capabilityの確認
pmoke instruments [-h, --help] <COMMAND>| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke instruments list
対応装置モデル一覧
pmoke instruments list [--json] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--json | - | - | machine-readable JSON出力 | - |
-h, --help | - | - | help表示 | - |
pmoke instruments explain
対応装置モデルの説明
pmoke instruments explain <MODEL> [--json] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
<MODEL> | 必須 | - | 装置モデル名。例: Keithley2010。 | - |
--json | - | - | machine-readable JSON出力 | - |
-h, --help | - | - | help表示 | - |
pmoke instruments query
接続URIへの単一SCPI text query
pmoke instruments query --connection <URI> [--timeout-ms <MS>] [--json] <COMMAND> [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--connection <URI> | 必須 | - | 接続URI。例: prologix-tcp://host:1234?addr=17。 | - |
--timeout-ms <MS> | - | 3000 | URIにtransport固有のtimeoutがない場合に使用するtimeout | - |
--json | - | - | machine-readable JSON出力 | - |
<COMMAND> | 必須 | - | SCPI query command。例: *IDN?。 | - |
-h, --help | - | - | help表示 | - |
pmoke bench
装置transportのリクエスト遅延benchmark
pmoke bench [-h, --help] <COMMAND>| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke bench scpi-query
単一SCPI queryのbenchmarkと再現性report保存
pmoke bench scpi-query --connection <URI> [--command <COMMAND>] [-n, --iterations <N>] [--warmup <N>] [--timeout-ms <MS>] [-o, --output <FILE>] [--json] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--connection <URI> | 必須 | - | pmoke instruments queryで使用する接続URI | - |
--command <COMMAND> | - | *IDN? | benchmark対象のSCPI query command | - |
-n, --iterations <N> | - | 50 | 計測するquery回数 | - |
--warmup <N> | - | 3 | 計測前に実行する非記録query回数 | - |
--timeout-ms <MS> | - | 3000 | URIにtransport固有のtimeoutがない場合に使用するtimeout | - |
-o, --output <FILE> | - | - | run benchmark directoryに代わるFILEへのTOML保存 | - |
--json | - | - | TOML保存後のcompact report JSON出力 | - |
-h, --help | - | - | help表示 | - |
pmoke bench transport
接続URIのtext request/response latency計測
pmoke bench transport --connection <URI> [--protocol <PROTOCOL>] [-r, --request <TEXT>] [-n, --iterations <N>] [--warmup <N>] [--timeout-ms <MS>] [-o, --output <FILE>] [--json] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--connection <URI> | 必須 | - | pmoke instruments queryで使用する接続URI | - |
--protocol <PROTOCOL> | - | scpi; scpi, line | 各requestを検証するtext protocol | - |
-r, --request <TEXT> | - | *IDN? | benchmark対象request。複数指定時の反復option。 | - |
-n, --iterations <N> | - | 50 | requestごとの計測回数 | - |
--warmup <N> | - | 3 | 各計測前に実行する非記録request回数 | - |
--timeout-ms <MS> | - | 3000 | URIにtransport固有のtimeoutがない場合に使用するtimeout | - |
-o, --output <FILE> | - | - | 完全JSON reportのファイル保存 | - |
--json | - | - | 完全reportのJSON出力 | - |
-h, --help | - | - | help表示 | - |
pmoke export
保存データの交換形式export
pmoke export [-h, --help] <COMMAND>| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke export csv
検証済みRAW波形directoryのCSV変換
pmoke export csv [--input <DIR>] [--output <FILE>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--input <DIR> | - | - | RAW取得directory。既定値acquisition/、legacy fallbackあり。 | - |
--output <FILE> | - | - | CSV出力先。既定値acquisition/waveforms/waveform.csv。 | - |
-h, --help | - | - | help表示 | - |
pmoke export npy
解析結果CSVのNumPy table変換
pmoke export npy [--output <DIR>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--output <DIR> | - | - | 出力directory。既定値は標準解析CSVと同じ場所のNPY。 | - |
-h, --help | - | - | help表示 | - |
pmoke doctor
設定、ストレージ、Python、接続装置の診断
pmoke doctor [--json] [--probe-fetch] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--json | - | - | machine-readable JSON report出力 | - |
--probe-fetch | - | - | オシロスコープを停止するactive checkの許可(停止状態のまま残る) | - |
-h, --help | - | - | help表示 | - |
pmoke single
オシロスコープのsingle mode設定
必要なfeature:
hw-core
pmoke single [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke trigger
ファンクションジェネレータからのtrigger送信
必要なfeature:
hw-core
pmoke trigger [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke autoshot
single mode設定とtrigger送信
必要なfeature:
hw-core
pmoke autoshot [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke fetch
オシロスコープデータの取得・保存
必要なfeature:
hw-core
pmoke fetch [--format <FORMAT>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--format <FORMAT> | - | csv, raw, csv-and-raw | config [fetch].outputに対する出力形式override | - |
-h, --help | - | - | help表示 | - |
pmoke screenshot
オシロスコープ画面のPC直接取得
必要なfeature:
hw-core
pmoke screenshot [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke automeasure
single mode・trigger・fetchの自動測定
必要なfeature:
hw-core
pmoke automeasure [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke reference
記録したEOM駆動正弦波をフィッティング
pmoke reference [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke sensor
センサー信号解析
pmoke sensor [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke li
数値lock-in解析
pmoke li [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke signal
lock-in窓での生信号channel平均
pmoke signal [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke phase
lock-in解析の参照位相回転
pmoke phase [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke moke
Kerr角度を計算
pmoke moke [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke analyze
sensor・reference・signal・lock-in・phase・mokeの全解析
pmoke analyze [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke compare-lockin
共有データ・固定window gridでのlock-in推定器比較(結果を新規directoryへ)
pmoke compare-lockin --request <FILE> [--output <DIR>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--request <FILE> | 必須 | - | 比較requestファイルのpath | - |
--output <DIR> | - | - | requestの出力directoryの上書き | - |
-h, --help | - | - | help表示 | - |
pmoke evaluate-lockin
凍結protocolによるpaired lock-in baseline・candidate値の評価とJSON report出力
pmoke evaluate-lockin --request <FILE> [--output <FILE>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--request <FILE> | 必須 | - | 評価requestファイルのpath | - |
--output <FILE> | - | - | requestと別のFILEへreportを書き出す | - |
-h, --help | - | - | help表示 | - |
pmoke calibrate
記録済みデータからの較正artifactのbuild・inspect・validate
pmoke calibrate [-h, --help] <COMMAND>| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke calibrate build
記録波形からの不変較正artifactのbuild(CSV requestまたはRAW run直接)
pmoke calibrate build [--request <FILE>] [--output <DIR>] [--run <DIR>] [--channel <N>] [--model-id <ID>] [--reference-channel <N>] [--reference-frequency-hz <HZ>] [--reference-phase-rad <RAD>] [--block-len <N>] [--seed <N>] [--frequency-rel-tol <TOL>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--request <FILE> | - | - | 較正build requestファイルのpath | block_len, channel, model_id, reference_channel, reference_frequency_hz, reference_phase_rad, run, seed |
--output <DIR> | - | - | requestの出力directoryの上書き | - |
--run <DIR> | - | - | 直接build用の記録済みrun directory(既定: カレントdirectory) | request |
--channel <N> | - | - | 直接buildの対象channel(複数可。既定: run設定のsignal channel) | request |
--model-id <ID> | - | - | 単一channel直接build用のmodel識別子 | request |
--reference-channel <N> | - | - | 直接buildの同run参照fitに使う参照channel | request |
--reference-frequency-hz <HZ> | - | - | 直接build用の参照周波数Hz(既定: 同runのfit値) | request |
--reference-phase-rad <RAD> | - | - | 直接build用の参照位相rad(既定: 同runのfit値) | request |
--block-len <N> | - | - | 直接build用のblock長サンプル数(既定: サンプル数÷40) | request |
--seed <N> | - | - | 直接build用の乱数seed(既定: 0) | request |
--frequency-rel-tol <TOL> | - | - | 直接build用の参照周波数適用tolerance上書き(相対値。既定: 不確かさ合成; 値は記録され上書きが明示される) | request |
-h, --help | - | - | help表示 | - |
pmoke calibrate inspect
較正artifactファイルのinspect(読み取り専用)
pmoke calibrate inspect --artifact <FILE> [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--artifact <FILE> | 必須 | - | 較正artifact JSONファイルのpath | - |
-h, --help | - | - | help表示 | - |
pmoke calibrate validate
推論contextに対する較正artifactのvalidate(読み取り専用)
pmoke calibrate validate --artifact <FILE> --context <FILE> [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--artifact <FILE> | 必須 | - | 較正artifact JSONファイルのpath | - |
--context <FILE> | 必須 | - | 適用性context TOMLファイルのpath | - |
-h, --help | - | - | help表示 | - |
pmoke noise
記録済みデータのパルスノイズ診断・比較・再実行
pmoke noise [-h, --help] <COMMAND>| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke noise diagnose
記録済みデータのノイズ診断計画(新規destinationへ)
pmoke noise diagnose --request <FILE> [--output <DIR>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--request <FILE> | 必須 | - | ノイズ診断requestファイルのpath | - |
--output <DIR> | - | - | requestの出力directoryの上書き | - |
-h, --help | - | - | help表示 | - |
pmoke noise compare
凍結グローバル較正と比較ワークフローの実行
pmoke noise compare --request <FILE> [--output <DIR>] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--request <FILE> | 必須 | - | ノイズ比較requestファイルのpath | - |
--output <DIR> | - | - | requestの出力directoryの上書き | - |
-h, --help | - | - | help表示 | - |
pmoke noise replay
コミット済み比較世代の検証とphase → MOKE → NPY replay
pmoke noise replay --destination <DIR> [--output <DIR>] [--verify-only] [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
--destination <DIR> | 必須 | - | コミット済みノイズ比較destination directory | - |
--output <DIR> | - | - | replay先(既定: <destination>/replay) | - |
--verify-only | - | - | digestと意味スキーマの検証のみ(書き込みなし) | - |
-h, --help | - | - | help表示 | - |
pmoke process
手動pulse trigger後のfetch・lock-in・phase・moke自動解析
必要なfeature:
hw-core
pmoke process [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke auto
完全自動測定・解析
必要なfeature:
hw-core
pmoke auto [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
-h, --help | - | - | help表示 | - |
pmoke completions
shell completion scriptの生成
pmoke completions <SHELL> [-h, --help]| option | 必須 | 既定値 / 候補 | 説明 | 競合 |
|---|---|---|---|---|
<SHELL> | 必須 | bash, elvish, fish, powershell, zsh | 生成対象shell: bash、zsh、fish、powershell、elvish。 | - |
-h, --help | - | - | help表示 | - |