設定

設定リファレンス

pmoke config schema version 5の自動生成fieldリファレンス。

型付きconfig metadata registryから自動生成。手動編集は上書き対象。

pmoke: 0.4.0
config schema: 5
source: 9107b7e40779

JSON Schema · pmoke config explain

`version`

path	型	必須状態	既定値 / 候補	説明・制約
`version`	`integer`	必須	`5`	設定スキーマのバージョン新規設定と移行済み設定で使用するバージョン5。制約: must equal 5

`scope`

path	型	必須状態	既定値 / 候補	説明・制約
`scope`	`table`	必須	-	オシロスコープ設定登録済みモデルと通信URIの組み合わせ。
`scope.model`	`string`	必須	`DHO5108`	オシロスコープモデル instruments crateに登録されたモデル名との一致。制約: must be a registered oscilloscope model
`scope.connection`	`connection URI`	必須	`tcp://`, `visa:`, `gpib://`	オシロスコープの通信URI DHO5108で使用するdirect TCP/IP。Prologix transport対象外。制約: transport must be supported by the model and build features

`generator`

path	型	必須状態	既定値 / 候補	説明・制約
`generator`	`table`	任意	`absent`	任意のファンクションジェネレータ設定 triggerまたは自動測定系commandで必要な装置設定。制約: required by trigger, autoshot, automeasure, and auto
`generator.model`	`string`	条件付き	`WF1946B`	ファンクションジェネレータモデル generator table使用時に必要な登録名。制約: must be a registered generator model
`generator.connection`	`connection URI`	条件付き	`gpib://`, `prologix-tcp://`, `prologix-serial://`	ファンクションジェネレータの通信URI native GPIBまたはPrologix TCP/serialの選択。制約: transport must be supported by the model and build features

`data`

path	型	必須状態	既定値 / 候補	説明・制約
`data`	`table`	必須	-	取得データ方針標準波形形式と任意のスクリーンショット取得の設定。
`data.output`	`string enum`	必須	`csv`, `raw`, `both`	取得波形の保存形式大規模取得向けraw、CSV併記向けboth。
`data.input`	`string enum`	必須	`csv`, `raw`, `auto`	解析波形の入力形式利用可能な標準データを選ぶauto。検証済みraw優先。
`data.screenshot`	`boolean`	任意	`false`; `true`, `false`	オシロスコープ画面取得 display transfer対応モデル・通信方式での任意取得。制約: DHO5108 capture requires TCP/IP or USB-TMC

`sensors`

path	型	必須状態	既定値 / 候補	説明・制約
`sensors`	`array of tables`	条件付き	`[]`	センサーチャンネル一覧各channelと単一scale方針の対応。制約: channels must not overlap reference or lock-in signal channels

`sensors[]`

path	型	必須状態	既定値 / 候補	説明・制約
`sensors[].channel`	`integer`	必須	-	センサーチャンネル番号 DHO5108向け1以上8以下の番号。制約: 1 <= value <= 8; must be unique across all channel roles
`sensors[].scale`	`inline table union`	必須	`{ factor = ... }`, `{ max_abs = ..., polarity = ... }`	センサー変換規則直接係数または最大絶対値正規化の択一。制約: factor and max_abs forms are mutually exclusive
`sensors[].scale.factor`	`float`	条件付き	-	線形センサー変換係数積分センサー値への直接乗算。制約: must be finite and non-zero
`sensors[].scale.max_abs`	`float`	条件付き	-	最大絶対値の正規化目標測定最大絶対値に対応する正の目標値。制約: must be finite and positive
`sensors[].scale.polarity`	`integer enum`	条件付き	`-1`, `1`	最大絶対値正規化の極性 max_abs使用時の必須符号。制約: must equal -1 or 1
`sensors[].label`	`string`	必須	-	センサープロットラベル TOML literal stringで指定可能なMatplotlib mathtext。制約: must not be empty
`sensors[].unit`	`string`	必須	-	変換後センサーの出力単位表・プロット・解析保存headerでの単位。制約: must not be empty

`pulse`

path	型	必須状態	既定値 / 候補	説明・制約
`pulse`	`table`	必須	-	パルス背景区間パルス前後のベースライン領域。制約: background windows must not overlap
`pulse.background_before`	`inline time window` · `s`	必須	-	パルス前背景区間有限なstartとendのinline table。制約: start < end
`pulse.background_after`	`inline time window` · `s`	必須	-	パルス後背景区間有限なstartとendのinline table。制約: start < end

`reference`

path	型	必須状態	既定値 / 候補	説明・制約
`reference`	`table`	必須	-	EOM駆動用正弦波の解析設定 EOMへ入力するファンクションジェネレータ正弦波の記録チャンネル、FFT区間、fit間引きを指定。
`reference.channel`	`integer`	必須	-	EOM駆動信号の記録チャンネル EOMへ入力するファンクションジェネレータ正弦波を記録するDHO5108の1以上8以下のチャンネル。制約: 1 <= value <= 8; must be unique across all channel roles
`reference.fft_window`	`inline time window` · `s`	必須	-	EOM駆動信号FFTの時間区間記録した正弦波の安定区間を表す有限なstartとend。制約: start < end
`reference.stride_samples`	`integer` · `samples`	必須	-	EOM駆動正弦波fitの間引き幅計算量と時間分解能の調整値。制約: must be positive
`reference.window_samples`	`integer` · `samples`	必須	-	局所EOM駆動正弦波fitの窓幅 FFT推定値周辺で使用するsample数。制約: must be positive

`lockin`

path	型	必須状態	既定値 / 候補	説明・制約
`lockin`	`table`	必須	-	数値lock-in設定信号channel、並列度、出力間引き、low-pass filterの指定。
`lockin.signal_channels`	`integer array`	条件付き	-	lock-in 復調対象チャンネル lock-inと後段解析で必要な1件以上のchannel番号。制約: each value must be in 1..=8; must be unique across all channel roles
`lockin.workers`	`integer`	必須	-	lock-inの並列worker数物理CPU数付近を初期値とする並列度。制約: must be positive
`lockin.stride_samples`	`integer` · `samples`	必須	-	lock-in 出力間引き幅入力sample rateを割るsample数。出力sample rateを決定。制約: must be positive
`lockin.filter`	`tagged inline table`	必須	-	lock-in low-pass filter 設定 schema v5ではboxcar_legacyのみを使用。制約: fields from other filter kinds are rejected
`lockin.filter.kind`	`string enum`	必須	`boxcar_legacy`	lock-in filter アルゴリズム現在のLPFはboxcar_legacyのみ。過去のFIR/IIR kindは移行診断のためだけに読み取る。
`lockin.filter.half_window_cycles`	`float` · `reference cycles`	必須	-	参照周期単位の半窓幅 boxcar積分窓を参照周期単位で指定する半窓幅。制約: must be finite and positive
`lockin.debug_output`	`boolean`	任意	`false`; `true`, `false`	lock-in debug artifact 出力 filter調査時のみ有効化する大容量artifact出力。
`lockin.debug_label`	`string`	任意	`absent`	debug artifactの安全なsuffix 短いASCII filename-safe文字列。制約: 1-64 ASCII alphanumeric, '.', '_', or '-'; must not be '.' or '..'
`lockin.debug_overwrite`	`boolean`	任意	`false`; `true`, `false`	debug artifact 上書き方針同名debug出力の置換許可。
`lockin.snr_background_window`	`inline time window` · `s`	任意	`absent`	SNR 診断用背景区間有限なstartとendの任意inline table。制約: start < end
`lockin.snr_signal_window`	`inline time window` · `s`	任意	`absent`	SNR 診断用信号区間有限なstartとendの任意inline table。制約: start < end
`lockin.save_npy`	`boolean`	任意	`false`; `true`, `false`	lock-in結果のNumPy出力標準CSVに追加するNPY artifact。

`phase`

path	型	必須状態	既定値 / 候補	説明・制約
`phase`	`table`	必須	-	位相回転設定第1から第6高調波のoffset。
`phase.offsets`	`float or expression array` · `rad`	必須	-	6高調波の位相offset pi/2などの数式指定に対応するrad値。制約: must contain exactly 6 finite values

`kerr`

path	型	必須状態	既定値 / 候補	説明・制約
`kerr`	`table`	必須	-	Kerr角度の変換設定校正用センサー、計算方法、最終係数を指定。
`kerr.sensor`	`integer`	必須	-	Kerr角度の校正に使用するセンサーチャンネル sensors配列に存在するチャンネルを指定。制約: must reference sensors[].channel
`kerr.method`	`string enum`	必須	`standard`, `harmonics`	Kerr角度の計算方法 standardまたはharmonics実装を選択。
`kerr.factor`	`float`	必須	-	Kerr角度の最終変換係数選択したKerr角度計算後に乗算する値。制約: must be finite

`plot`

path	型	必須状態	既定値 / 候補	説明・制約
`plot`	`table`	任意	`defaults`	プロット生成設定表示・保存、間引き、失敗方針の指定。
`plot.mode`	`string enum`	任意	`save`; `off`, `save`, `interactive`, `both`	plot出力mode batch向けsaveとMatplotlib window向けinteractive。
`plot.max_points`	`integer` · `points per series`	任意	`100000`	プロット入力の最大点数大規模取得時のMatplotlib応答性調整値。制約: must be positive
`plot.decimation`	`string enum`	任意	`stride`; `none`, `stride`, `min_max`	プロット間引きアルゴリズム狭い極値の保持に適したmin_max。
`plot.on_error`	`string enum`	任意	`warn`; `warn`, `fail`	プロット失敗方針解析成功を保持するwarnと致命扱いのfail。
`plot.output_dir`	`string`	任意	`absent`	非推奨のplot directory互換field version 5で受理後に無視される値。artifactは標準run layout。制約: ignored with a warning

検証・移行

schema error の診断と legacy 設定の安全な移行。

波形アナライザー

ネイティブ実装と数値が一致する、ブラウザ内のlock-in・位相回転・高調波成分からのKerr角度計算。

目次

versionscopegeneratordatasensorssensors[]pulsereferencelockinphasekerrplot