SGT-Meter7_20260423 Help

[概要]

このプログラムは計測器から送信されるTA値を読み取り、その変化をリアルタイムに表示します。

プログラムの構成

HTML + css + JavaScript から構成されたブラウザベースのローカルアプリです。

パソコンにコピーしたHTMLファイルをブラウザへ読み込むことで実行できます。

Windows 11環境にて標準のブラウザとGoogle Chromeで動作を確認しました。

ファイルアクセス

プログラムの構成ファイル以外に次のファイルへアクセスします。

ログファイル：セッションログをブラウザのダウンロードフォルダへ出力します。
プロセス定義ファイル：利用者が指定したプロセス定義ファイルを読み込みます。

通信

ブラウザの機能を使用してパソコンに接続した計測器とUSBを介した通信を行います。

インターネットへの送受信や他のプログラム等との通信を行いません。

[簡単な使い方]

ファイルのコピー

「sgt-meter7」ディレクトリをパソコンの任意のディレクトリへコピーします。
計測器を接続

s-meterまたはd-meterをパソコンへ接続します。

正常に起動すると計測器のLEDが約1秒間隔で点滅します。
SGT-Meter7を起動

コピーした「sgt-meter7」ディレクトリ内の「index.html」をブラウザから開きます。

(拡張子を表示しない環境では「index」と表示されます)

全体が欠けることなく、なるべく大きく表示されるように拡大/縮小してサイズを調整します。

拡大/縮小した場合、メーターの表示がぼやけるので、ページを再読み込みします。
計測器との通信を開始

[Connect]ボタンをクリックします。

シリアルポートへの接続を要求する画面が表示されるので、「Board CDC …」と表示される項目を選択し[接続]をクリックします。
簡単な操作説明
- メインメーター(大きいメーター)上でのホイール操作により感度を調整します。
- TAメーター(小さいメーター)上でのホイール操作によりTAポジションを調整します(トーンアームの操作)。
- どちらのメーターもクリックするとTAセットを実行します。
- [A]をチェックすると自動セットが有効となります。
  
  自動セットが有効な場合、針が振り切れた状態が一定時間継続するとTAセットが実行されます。
  
  デフォルトの待ち時間は0.2秒です。
- [X]をチェックするとメインメーターの針の可動範囲が180°となり、それを超えると逆側へ回り込みます。
  
  デフォルトの最大周回数は±2周です。
- [C]のチェックを外すと感度補正が無効になります。
  
  デフォルトでは感度補正が有効です。

[セッション管理]

開始

セッション開始時に[Session Start]をクリックします。

セッション中はTAアクションがカウントされ、次の情報を[Session Log]へ出力します。

開始時に「開始メッセージ」、「感度」、「TAポジション値」
TAセット実行時に「TAポジション値」、「最大リード値」
TAセット時にTAアクションが加算された場合は、加算後の「カウント」
感度を変更した場合、TAセットが行われたタイミングで変更後の「感度」
カウンタを履歴から操作した場合、変更後の「カウント」
表示したコマンド
[Mark]ボタンのクリックにより「####### Markの連番 #######」を出力

ワークシートへこの番号を記載しておけば、ログとの突き合わせがやりやすくなります。

セッション開始時にMarkの連番、TAアクション、および[Session Log]がクリアされます。

終了

セッション終了時(または中断時)に[Session Stop]をクリックします。

終了時に「セッション時間」、「カウント」、「終了メッセージ」を出力します。

セッションログがブラウザのダウンロードフォルダへ出力されます。

[コマンド表示と読み上げ]

プロセス定義ファイルを読み込むことで、画面へコマンドを表示し、読み上げることができます。

[設定]の[ファイルを選択]からプロセス定義ファイルを指定し読み込みます。

プロセス定義ファイルの書式

"//" で始まる行は無視される
空行は無視される
1つのファイルに複数のプロセスを定義できる
プロセスはプロセス行と0行以上のコマンド行で定義する
プロセス行は"@"で始め、プロセス名と20行以下の説明文で記述する
プロセス行の書式は次の通り

　"@プロセス名|説明文1行目|説明文2行目|… |説明文20行目"　

説明文がない場合は "|" 以降を省略可能
プロセス行に続く"@"以外で始まる行がコマンド行となる
コマンド行はコマンド本体と20行以下の説明文で記述する
コマンド行の書式は次の通り

　"コマンド本体|説明文1行目|説明文2行目|… |説明文20行目"　

説明文がない場合は "|" 以降を省略可能

コマンド本体は空でも構わない
コマンド本体はメーター上部へ太字で表示され読み上げ対象となる
説明文はメーター下部へ表示される
コマンド本体に ") " を含む場合、この文字列までは読み上げ対象外となる

(半角閉じ括弧 + スペース)

プロセス定義ファイルの例

「command」ディレクトリにプロセス定義ファイルの例を準備していますので参考にしてください。

「command/sample_mb.txt」

『最小の橋』からプロセスを抜粋しています。説明文は原文から若干修正しています。

このファイルを使用するならば、必ず『最小の橋』をよく読んで理解してから自己責任で利用してください。

原文と意味やニュアンスが変わっていると感じられる場合は適切に修正してください。
「command/sample_trom.txt」

『The Resolution of the Mind』からエクササイズを抜粋しています。コマンドと説明文はAIによる翻訳です。

このファイルを使用するならば、必ず『The Resolution of the Mind』をよく読んで理解してから自己責任で利用してください。

原文と意味やニュアンスが変わっていると感じられる場合は適切に修正してください。

共通プロセスについて

「command/commonCommands.js」に定義されたプロセスは、アプリ起動時に読み込まれます。

また、プロセス定義ファイルを読み込んだ際にはその末尾に追加されます。

状況に応じて不定期に利用されるボタン等の定義を想定しています。必要に応じて修正してください。

このファイルではプロセスを変数の値として記述しますが、書式はプロセス定義ファイルと同じです。

サンプルとして『最小の橋』からボタンを抜粋しています。説明文は原文から若干修正しています。

このサンプルをそのまま使用するならば、必ず『最小の橋』をよく読んで理解してから自己責任で利用してください。

原文と意味やニュアンスが変わっていると感じられる場合は適切に修正してください。

操作の説明

メインメーターの右上に配置されたセレクタやボタンを使用してコマンドを操作します。

[ファイルを選択] : プロセス定義ファイル読み込み: このボタンのみ設定領域に配置されます。; ファイル選択画面からプロセス定義ファイルを指定し読み込みます。; 以前に読み込んでいたプロセス定義はクリアされ、読み込み後「command/commonCommands.js」; に定義されたプロセスが末尾に追加されます。
[セレクトボックス] : プロセスを選択: セッションを開始している場合、[Session Log]へ選択したプロセス名を出力します。
[⏮] : 前のコマンドを表示: セッションを開始している場合、[Session Log]へ表示されたコマンドを出力します。; [b]キーからも操作可能です。
[⏭] : 次のコマンドを表示: セッションを開始している場合、[Session Log]へ表示されたコマンドを出力します。; [n]キーからも操作可能です。
[▶] : コマンドを読み上げ: 現在のコマンドを読み上げます。; [h]キーからも操作可能です。
[⬛] : 読み上げ停止: [h]キーからも操作可能です。
[□🔉] : コマンド読み上げ設定: 有効にした場合、コマンドが切り替わるタイミングで読み上げます。; [v]キーからも操作可能です。

[表示と操作の説明]

上段

[Connect]、 [Session Start]、 [Session Stop] : 状態によって表示文字が変化
TIME : 総セッション時間: [Session Start]をクリックすると時間計測を開始し、[Session Stop]クリックにより中断します。; 再度[Session start]をクリックすると計測を再開します。; 時間を0にリセットするにはアプリを再読み込みしてください。
COUNT : アクションカウンタ: セッション中のみTAポジションが下がる操作を行った場合、その差分をTAアクションとしてカウントします。; TAセットの実行によるカウントは変更履歴へ保持されます。; ホイール操作によるTAポジションの変更については変更履歴へ保持されません。; ボディアクション等による無効なカウントを履歴から戻すことができます。; セッション開始時に0にリセットされます。
[<] : 履歴からCOUNTを戻す: [,]キーからも操作可能です。
[>] : 履歴からCOUNTを進める: [.]キーからも操作可能です。
日付・時刻 : パソコンのシステム時刻表示
[≡]、 [∧] : 設定を表示、設定を非表示: 設定領域の表示 / 非表示を切り替えます。

設定領域

wait : 自動セット待ち時間(秒)
laps : 拡張モード時の最大周回数
wgt,dmp：慣性と制動の設定: メインメーターに対して、物理的なメーターが持つ慣性をシミュレートする設定です。; 調整することで、伝統的なメーターや他の物理的なメーターと似たような挙動に近づけることができます。; 伝統的なメーターは意図的に針が揺れるように調整しているようです。; emaとsmaがデフォルト値の場合; ・wgt=70, dmp=0.03 付近に設定すると伝統的なメーターと近い挙動となります。; ・wgt=8, dmp=0.25 付近に設定するとAbilityメーターと近い挙動となります。(デフォルト値); wgt=1, dmp=0 と設定した場合は制動および慣性をシミュレートしません。
ema,sma：フィルタ設定: 測定値の平滑化にかかかわる設定です。; 測定値には誤差によるばらつきがあるため、そのまま表示すると針が小刻みに動きます。; これらの設定を調整し平滑化することで針が滑らかに動くようになります。; この設定はメインメーターとTAメーターの両方に影響します。; （物理的なメーターは、機械的または電気回路的に平滑化の仕組みが組み込まれています）
ファイルを選択 : プロセス定義ファイルを読み込む: [コマンド表示と読み上げ]セクションを参照
sps : 1秒間のサンプル数: 計測器から読み取ったサンプル数の実測値です。
gain : 感度補正の倍率: 感度補正が有効な場合、補正倍率と補正後の感度値を表示します。
Reset : 設定を初期値に戻す: controller.jsの最初の7行を修正することで初期値をカスタマイズできます。

メーター領域

POS : TAポジション値、セット位置のTA値
PC : PCのTA値
DIFF : PC と POS の差分
LAP : 針の周回数
READ : リード値: セット位置からの針の振れ幅(インチ)を表示します。; 伝統的な物理メーターのサイズに合わせて1目盛を1/8インチとして計算します。; スケールの範囲を超えると "++" または "--" と表示します。; Small Fall : 0.25 ～ 0.75; Fall : 0.75 ～ 1.75 または 1 ~ 2; Long Fall : 1.75以上または 2 ~ 3
SENS : 感度設定: [<]、[>] またはスライダーを操作して感度を設定します。; カーソルキーからも調整可能です。
A : 自動セット設定: 有効にした場合、針が振り切れた状態が一定時間継続するとTAセットが実行されます。; デフォルトの待ち時間は0.2秒です。; [z]キーからも操作可能です。
X : 拡張モード設定: 有効にした場合、針の可動範囲が180°となり、可動域を超えると逆側へ回り込みます。; デフォルトの最大周回数は±2回転です。; [x]キーからも操作可能です。
C : 感度補正設定: 有効にした場合、TAポジション値が2.6～4.3の間は、抵抗値の変化量と針の振れ幅が比例するように補正します。; この範囲を超えると補正が穏やかになります。; 無効にした場合、TAの変化量と針の振れ幅が比例します。; セッション開始時にTAが高い場合は、無効状態で感度を調整することをお勧めします。; （伝統的な解説本通りに設定すると、感度補正により適正感度より低くなってしまうため）; [c]キーからも操作可能です。
メーター(小) :TA メーター: フルスケールでPCのTAを示します。グレーの範囲は0.95~6.5です。; クリックするとTAセットを実行します。; ホイール操作によりTAポジションを調整できます(トーンアームの操作と同様)。; この操作によるTAポジションの変更はTAアクションに加算されますが、履歴としては保存されません。
メーター(大) :メインメーター: クリックするとTAセットを実行します。; ホイール操作により感度を調整できます。
コマンドコントロール(メインメーター右上) : プロセス/コマンドの操作: [コマンド表示と読み上げ]セクションを参照

ログ領域

[Session Log]エリア : セッションログ: セッション中に各種情報を出力します。; 計測器と接続または切断された場合、メッセージを出力します。
[Mark] : セッションログへマークを出力: セッション中のみ利用可能です。; [m]キーからも操作可能です。
[?] : ヘルプ画面を表示

マウス操作

[TAメーター]: [クリック] : TAセットを実行; [ホイール] : TAポジションを操作
[メインメーター]: [クリック] : TAセットを実行; [ホイール] : 感度を操作
各スライダー(およびそのラベル): [ホイール] : スライダーを操作

キーボード操作

[←] : 感度を3.5%減らす

[→] : 感度を3.5%増やす

[↑] : 感度を2倍する

[↓] : 感度を半分にする

[スペース] : TAセット実行

[z] : 自動セット切替

[x] : 拡張モード切替

[c] : 感度補正切替

[v] : 読み上げモード切替

[b] : 前のコマンドを表示する

[n] : 次のコマンドを表示する

[h] : 読み上げ中の音声を停止する／現在のコマンドを読み上げる

[m] : ログへマークを出力する

[,] : 履歴からカウンタを戻す

[.] : 履歴からカウンタを進める

[ファイルの説明]

index.html

メインのHTMLです。
sgtm7.css

index.html用のCSSです。
help.html

ヘルプファイルです。
controller.js

メインのスクリプトです。
command.js

コマンド表示・読み上げのスクリプトです。
sgtmeter.js

メーターの振る舞いをモデル化したクラスを定義しています。
gauge.js

次のスクリプトを一部修正して利用しています。

https://github.com/bernii/gauge.js
command/commonCommands.js

共通プロセスを定義します。
command/sample_xxx.txt

プロセス定義ファイルのサンプルです。

[謝辞]

SGT-Meter7の開発には次にあげる方々の公開した情報が特に参考となりました。感謝いたします。

Old Timer氏

掲示板への投稿や『最小の橋』を読んだことがメーター開発に至ったきっかけです。

メーターを自作し始めた当初の目的は『最小の橋』を実践することでした。

プロセス定義ファイルのサンプルとして『最小の橋』から一部のプロセスを抜粋しました。
Ralph Hilton氏

メーターの仕組みの理解には、Hilton氏が設計した「FZ-Meter Mk RH4」が参考になりました。

抵抗値とTAの関係式「TA = PC/(PC + 21250)*5.559 + .941」はHilton氏の成果です。
emeter.de(Webサイト)

メーターの歴史や機能に関する考察が参考となりました。

感度の計算にはこのサイトに記載された式を使用しています。
ufz.yolasite.com(Webサイト)

感度補正の計算には、このサイトのレポートを参考としました。

針の慣性については、このサイトのムービーを参考としました。
Dennis Stephens氏

『The Resolution of the Mind』の著者です。

プロセス定義ファイルのサンプルとして『The Resolution of the Mind』から一部のエクササイズを抜粋しました。

Copyright (c) 2026 ShinGeTsu Meter.