LjStudio — キャリブレーションの考え方と手順

1. 読み方と、「ずれ」とは何か（器具 1 台に 9 つ）

この頁の読み方

1. 実機（本物のムービング）での校正は、まだ一度も確認していません。「実機で確認済み」と読める箇所は、この頁にはありません。傾きの符号（正のピッチがどちらへ倒れるか）も、実機では未確認です。
2. 出てくる数字（「傾き 1.5° で顔の高さ 24 cm 外れる」など）は、合成データの数値実験です。計算機の中で真の姿勢を決めて観測を作り、解き直した結果で、現場の実測ではありません。
3. 「合わなかったらその場で合わせる」は間違いではありません。ただし校正の代わりにはなりません。何が直って何が直らないかを、ずれの種類ごとに書きます。

「ずれ」とは何か

ムービング 1 台が「ここを狙え」に応えるとき、卓や LjStudio は次の前提で Pan/Tilt を計算しています。

• 器具は図面どおりの位置に吊ってある。
• 器具は図面どおりの向きで、水平に付いている。
• Pan/Tilt のゼロは取扱説明書どおりの向きにある。
• Pan/Tilt の可動角は公称どおり（540°／270° など）。

現場ではこの前提のどれもが少しずつ崩れます。崩れ方を数えると、次の 9 つになります。図の色分けは、LjStudio が解く物（シアン）と解かない物（灰色）の区別です。

数え方の注意: 参照用の別の解き手（CalibTrack）の誤差モデルは 10 項目（位置 3・ロール/ピッチ/ヨー・pan0/tilt0・kPan/kTilt）ですが、ヨーと pan0 は光だけからは見分けられないため、1 つにまとめて実質 9 つです（見分けられない理由は 3 章）。

位置のずれ（X・Y・Z）

• 現場でどう起きるか: 図面の吊り位置と、実際にクランプを掛けた位置の差。バトンやトラスのどこに掛けたか、ずらして付けた、など。高さ（Y）は、トラスのたわみや吊りワイヤーの長さでも変わります。
• 光にどう見えるか: 器具から離れた所ほど、狙いが同じ向きにずれて見えます。近くの点はほぼ合い、遠い点で外れます。高さ（Y）のずれは、Tilt のゼロのずれと混ざって見えます（3 章）。
• LjStudio が解くか: 解きます（3 つとも）。【確認】吊り位置を巻尺・レーザーで信じられるなら「位置は動かさず向きだけ解く」（mode=fixedpos）も選べます。

向きのずれ——ヨー（水平に回る向き）

• 現場でどう起きるか: 器具を取り付けるときの回転の向き。ベースの向きが図面と 1 本違う、など。
• 光にどう見えるか: 全体が左右に回ったようにずれます。Pan を動かす向きの全部に同じ角度のずれが乗ります。
• LjStudio が解くか: 解きます（取付ヨー 1 つ）。【確認】Pan のゼロのずれ（pan0）も、このヨーに吸収されます（3 章）。

向きのずれ——ピッチ・ロール（傾き）

• 現場でどう起きるか: 吊り金具の締め、トラスのたわみ、ベースの傾きで、器具の Pan 軸が鉛直（真上）からずれます。前後の傾きがピッチ、左右の傾きがロールです。これが「斜め」の正体です。
• 光にどう見えるか: Pan を回しても、床の落ち先が「中心の決まった円」を描きません。ある点で合わせても、別の方向へ振ると外れます（2 章）。目安は、ピッチ 1° で 10 m 先に 175 mm（CalibTrack の見積り）。【未照合】
• LjStudio が解くか: 2026-10-23 から解きます（6 自由度）。【確認】それまでは解かず、絵にも出ませんでした。現場でどれだけ傾くかは未計測で、トラス吊りで 0.5〜2° という見当は【推測】です。

Pan/Tilt の機械ゼロ（pan0・tilt0）

• 現場でどう起きるか: 器具のゼロ合わせ（工場出荷時の調整・リセット後の位置）が、取扱説明書の「Tilt 0＝真下」からわずかにずれている。
• 光にどう見えるか: pan0 は全体が回ったようにずれ、ヨーと同じ見え方になります。tilt0 は、全ての Tilt が同じ角度だけずれます（1° で 6 m 先に約 10 cm【推測】）。
• LjStudio が解くか: pan0 はヨーに吸収されて別には持ちません。【確認】tilt0 は解くことはできますが（mode=full+tilt0）、rig.json に置き場が無く、反映できません（結果の確認用）。【確認】

可動角の係数（kPan・kTilt）

• 現場でどう起きるか: 公称 540° の Pan が実測では 538° だった、のような差。機種の個体差・経年。
• 光にどう見えるか: 動かす幅が大きいほど、端でずれます。公称 540° が実測 538° のとき、端で 1° 弱。【推測】
• LjStudio が解くか: 解きません。【確認】器具の .spt（または GDTF）の値をそのまま信じます。残差が可動範囲の端で系統的に大きいときだけ疑う、という方針です。

下の 2 枚は、このあと 7 章で使う「模擬」の絵です。卓が信じている姿勢では光が目印に乗っている（傾き無し）のに、現実の器具が傾いていると光は外れる、という違いを並べます。どちらも Visualizer の絵で、実機ではありません。

▲ 先頭へ

2. なぜ「1 点で合わせる」では足りないか

2-1. 1 点合わせで直るもの・直らないもの

「ずれていたら、その場でスティックを寄せて合わせる」を、1 点オフセットと呼びます（grandMA3 の Patch の Offset Pan/Tilt と同じ考え方）。これは Pan と Tilt に一定の足し算をするだけです。

• 直る: Pan と Tilt が一定量ずれているだけのとき（ゼロ合わせの差、ヨーの小さなずれ）。合わせた点の近くでは、ほぼ合います。
• 直らない: 傾き（ピッチ・ロール）と、位置の誤り。これらは「方向によってずれ方が変わる」ずれなので、一定の足し算では打ち消せません。

Pan 軸が傾いていると、Pan を 1 周させたときの床の落ち先は、器具の真下を中心とした円ではなく、ずれた中心の円になります。1 点で合わせると、その点だけ合って、少し Pan を回した別の方向では傾きぶんだけ外れます。

下の絵は模擬（Visualizer の絵で、実機ではない）です。傾きを 2°／−1.5° にした現実の器具で、卓は目印を狙っているのに光が 0.60 m 外れています。

2-2. 数字（合成データの数値実験）

数値実験その 1（器具 6 m・床 4 点・目の合わせ誤差 0.3°・300 回平均。顔の高さ 1.6 m の平均のずれと、95% 点）:

• 傾きが 0.5° 以下なら、傾きを解かない従来の型で足ります。水平なら、未知数が少ない従来の型のほうがむしろ良いくらいです（4.9 対 7.9 cm）。
• 傾き 1.5° あたりから急に悪くなります。傾きを無視して位置だけ信じる型は、同じ条件で 47〜49 cm でした。

数値実験その 2（LjStudio の計算部で再現した結果。σ=0.3°・200 試行・5 点・顔の高さ 1.6 m の着地のずれの平均）:

読み方: 水平ならわずかに従来が良く、傾きが 1.5° を超えると 6 自由度が大きく勝ちます。2 つの実験は条件（点の数・試行回数）が違うので、数字を直接並べて比べないでください。

アプリでの通し（合成の観測）: 器具 1 台にピッチ 2°・ロール −1.5° を付けて 5 点を記録し、解いた結果の原文です。観測は計算機内の合成で、本物の器具ではありません。

• 6 自由度（mode=full）: 最大残差 0.7 cm・検証点 P5 が 0.9 cm で、真の傾き 2.0°／−1.5° に近い 2.1°／−1.5° に戻りました。反映すると 2.0°／−1.5°。
• 従来の 4 未知数（mode=yaw）: 最大残差 21.2 cm（悪い）で、高さを 6.5 m→6.9 m と間違えました。傾きを位置で誤魔化そうとした結果です。

calib solve 1 mode=yaw
  #1 悪い(最大残差21.2cm・5点・mode=yaw) (-6.8,6.5,3.0)/294°/傾き0.0°,0.0°→(-6.7,6.9,2.7)/294°/傾き0.0°,0.0°

calib solve 1 mode=full verify=P5
  #1 良い(最大残差0.7cm・4点・mode=full) 検証点P5:0.9cm (-6.8,6.5,3.0)/294°/傾き0.0°,0.0°→(-6.7,6.5,3.0)/294°/傾き2.1°,-1.5°

calib apply 1 mode=full
  1 台へ反映（控え: LjStudio.rig.json.bak）: #1 良い(最大残差0.9cm・5点・mode=full) (-6.8,6.5,3.0)/294°/傾き0.0°,0.0°→(-6.7,6.5,3.0)/294°/傾き2.0°,-1.5°

2-3. 「合わなかったらそこで合わせる」の位置づけ

• 開演前の近道としては正しい。小さなずれを 1 台 30 秒で直す手です。【推測】
• ただし、校正の代わりではありません。傾きや位置の誤りは、ある点で合わせても別の点で外れます。
• この近道（Pan/Tilt オフセットの記憶）は、LjStudio に入っています。実機では未確認です。

整理すると、次の分担です。

同じ 4 点で、1 点オフセットは合わせた点の近くだけ合い、6 自由度は全方向で合う、という比較図です。

▲ 先頭へ

3. 光からは見分けられない組み合わせ

校正は「光の向き」だけを観測します。そのため、光の向きが同じ変化になるずれは、区別できません。

3-1. ヨーと pan0

• ヨー（器具を取り付けた向き）と pan0（Pan のゼロ）は、どちらも鉛直軸まわりに全体を回すずれです。光の向きだけから見ると、同じ量だけ回ったことしか分かりません（CalibTrack の解析で、最小特異値が約 1e-8＝ほぼ区別できない）。
• そのため LjStudio は、ヨー 1 つで持ちます。pan0 を別に置きません。CalibTrack で同じデータをヨー 0 に固定して解くと、真のヨー（0／90／270°）は pan0 に 0.1° 以内で吸収されました。
• 実害は無く、ヨーに入った値は「取付の向き＋Pan のゼロのずれ」の合計として働きます。

3-2. tilt0 と高さ（またはピッチ）

• Pan がほぼ同じ向きの点ばかりだと、Tilt のゼロが合っていないことと、吊り位置が高すぎる・低すぎることが、同じ見え方になります。
• 区別するには、Pan が大きく違う点（器具の真下に近い点と、遠い点）を混ぜます。
• 高さの違うマーカー（段の上・台の上）を 1〜2 個混ぜると、床だけのときより精度が上がります。数値実験で、高さの誤差が 4.2→2.8 cm（約 3 割減）、顔の高さの平均が 8.0→6.6 cm（約 2 割減）でした。ただし「劇的ではない」改善です。

▲ 先頭へ

4. 何点要るか・どこに置くか

4-1. 点の数

1 点を狙うごとに、Pan と Tilt の 2 つの値が得られます。

3 点未満は、LjStudio は「断り」にして反映しません。

4-2. 置き方

• 2 m 以上離す。点の間隔が 1 m だと壊れました（向きが 11° 外れ、顔の高さで 130 cm）。LJ 本家のヘルプも「数 m 離す」です。
• 一直線にしない。ほぼ一直線のときは断ります。
• 高さの違う点を 1 つ混ぜる（3-2）。
• 器具から見て Pan が大きく違う点を混ぜる（3-2）。
• 5 点のうち 1 つは検証点にする（calib solve 1 verify=P5 のように指定）。計算に使わなかった点にも当たれば、合って見えるだけの解ではない、という確認になります。
• LJ 本家の流儀に従えば、器具ごとに別の 4 点でも構いません。できるだけ多くの器具から届く点にすると、置く手間が減ります。
• 会場には 6〜8 個のマーカーを置き、座標を 1 回だけ測る案です（例: 舞台前の左右・奥の左右・中央・客席通路）。

下はマーカー表の例です（P1〜P5。床の点は Y=0）。

4-3. CalibTrack の 9 未知数が 8〜9 点を要する理由

• 同じ合成データ（器具 3 台×マーカー 5 点）で、CalibTrack の 9 未知数は、DMX の 16bit 丸め（0.0082°）が入ると位置が 10.3 mm・tilt0 が 0.17° 外れ、合格線（位置 10 mm・角度 0.1°）を割りました。丸めなければ 0 です。
• LjStudio の 4 未知数は、同じ丸めでも 0.3 mm 以下・0.002° で余裕でした。
• つまり、未知数を増やすほど、点を増やさないと誤差に弱くなる。CalibTrack が実用 8〜9 点とする理由が数字で出ました。

4-4. 目の合わせ誤差

• 目で光の中心を印に合わせる誤差（仮定 0.3°）は、ほぼ比例して最終誤差に出ます。0.05°→1 cm、0.3°→5 cm、0.6°→11 cm、1.0°→17 cm。
• だから、極細のビームで合わせる・16bit の Pan/Tilt を使うのが効きます。

▲ 先頭へ

5. 今の LjStudio でできること（2026-10-23 時点）

LjStudio の取扱説明書（「校正シーン」「校正から位置を計算する」）に沿った手順です。以下の絵は、すべて模擬（Visualizer の絵）で、実機ではありません。

5-1. 準備: マーカーを置く・器具の姿勢を入れる

Rig setup の校正マーカー表に、会場で実測した点を入れます（名前は 12 文字まで・空白なし・床は Y=0）。AI からは marker add P1 -3 0 2。器具の姿勢（位置・ヨー・ピッチ°・ロール°）も同じ窓の欄に入ります。

5-2. 校正シーンに入る

入り方は 4 つあり、どれでも同じ状態になります。

• パッドの RT（PlayStation 系は R2）
• Q ボタン（名前が Calibration／キャリブレーション／校正で始まる Cue を呼ぶ）
• Visualizer 上の 2 段目の［校正シーン］ボタン
• AI から calscene on

入ると、ムービング全台がマーカー用のビームサイズで点きます。調べる 1 台だけが白く明るい細い光（床の光の直径 0.5 m）になり、ほかの器具は暗い色変化の光になります。

5-3. 寄せる

調べる器具の白い光が、床の目印に乗っているかを見ます。ずれていたら、左スティックで寄せます（LT を押しながらでゆっくり・R3 で元へ戻す）。AI からは calscene nudge <dX> <dZ>（m。X は右が＋、Z は客席側が＋）。下の絵は、調べる器具 #1 の白い光が P1 から外れている状態です（画面の帯は「ずれ なし」＝まだ寄せていない）。

5-4. 記録する

A を押す（AI からは calscene ok、または calib mark P1 3）と、その器具の Pan/Tilt（寄せたあとの値）が LjStudio.calib.json に記録され、次の器具へ進みます。下の絵は寄せたあとで、帯に「ずれ 左0.24 m・手前0.49 m」と出ています（寄せた分の表示）。光が P1 に乗っているので、ここで記録します。

• 目印に届かない器具は X（記録せずに要調整）、間違えたら Y でやり直し。
• 十字キー ← → で前後のマーカーへ。
• 回し方は 2 通りあります。「マーカーごとに回す」は、1 つの印に全器具を順に合わせてから次の印へ進む（校正シーンの既定）。「器具ごとに回す」は、1 台について全マーカーを記録してから次の器具へ進む（calscene ok は記録のたびに次の器具へ進むため、毎回 calscene fixture 1 で戻す）。どちらも命令で組めます。

5-5. 解く

Rig setup の［校正から計算…］、または calib solve [器具NO] [mode=…] [verify=P5] です（calib solve は書かない下見です）。mode は次の 5 つです。

解いた結果の原文（2 章の回と同じ）です。mode=yaw は悪く、mode=full verify=P5 は良く、反映すると傾きが 2.0°／−1.5° になります。

calib solve 1 mode=yaw
  #1 悪い(最大残差21.2cm・5点・mode=yaw) (-6.8,6.5,3.0)/294°/傾き0.0°,0.0°→(-6.7,6.9,2.7)/294°/傾き0.0°,0.0°

calib solve 1 mode=full verify=P5
  #1 良い(最大残差0.7cm・4点・mode=full) 検証点P5:0.9cm (-6.8,6.5,3.0)/294°/傾き0.0°,0.0°→(-6.7,6.5,3.0)/294°/傾き2.1°,-1.5°

calib apply 1 mode=full
  1 台へ反映（控え: LjStudio.rig.json.bak）: #1 良い(最大残差0.9cm・5点・mode=full) (-6.8,6.5,3.0)/294°/傾き0.0°,0.0°→(-6.7,6.5,3.0)/294°/傾き2.0°,-1.5°

5-6. 判定の読み方

結果の表には、器具ごとに使ったマーカー・残差・判定・解き方（mode）・旧→新の位置/ヨー/ピッチ/ロール・検証点の残差が並びます。

• 残差: マーカーの高さの面で、ビームが落ちる点とマーカーの距離（m）。
• 判定: 5 cm 未満が「良い」、20 cm 未満が「要確認」、それ以上は「悪い」。判定は計算に使った点だけで決めます。「悪い」の器具は、初めはチェックが外れています。
• 検証点: 計算に使わなかった点の残差。小さければ、合って見えるだけの解ではありません。
• 傾きの欄が「—」なのは 0 のところです。

断り: 次の場合は反映できません（中途半端な数字を黙って書かないため）。

1. 点が 3 つに足りない
2. マーカーどうしが近すぎる（2 m 未満）
3. ほぼ一直線
4. 計算が収束しない（発散）
5. 数値が壊れた（NaN）

5-7. 反映・取り消し

チェックを入れた器具だけを［反映］（AI から calib apply）。書く前に LjStudio.rig.json.bak に控えを残し、［元に戻す］（calib undo）で直前の反映を取り消せます（控えは 1 世代だけ）。書き先は LjStudio.rig.json の 1 本だけで、LightJockey の原本には書きません。

5-8. 確かめる

追尾を入れて、BACK＋十字キーでマーカー（P1〜P4）へ跳び、全台のビームが印に当たるかを見ます。下の 2 枚は、解いて反映したあとの P1 と P3 です。寄せ無しで光が目印に乗っています（帯は「記録 5 点」）。

5-9. できないこと

• kPan/kTilt は解きません。
• tilt0 は解けても反映先がありません。
• 初期値が大きく外れた場合（半回転・上下逆の解）は未検証です。rig.json が空のまま解くのは避けてください。
• .spt の無い器具は、GDTF を読めるようになりましたが（符号は仮定・実機未確認）、実物の GDTF での検算は未です。
• 実機では一度も通していません。

▲ 先頭へ

6. 現場の手順（段取り表）

出典のある時間の目安だけを入れます。ほかの数字は未確認です。

• 40 台全体の所要は、「1 台 3〜4 分・約 3 時間」の見積りに対し、見直しで「55〜110 分＋マーカー係の移動」と見込みました。どちらも【推測】で、現地の 1 台目・10 台目で実測して見直す前提です。
• 人は 2 名（マーカー係と LjStudio 係）の想定です。マーカーごとに回すと、マーカー係は 1 巡で済みます。
• 卓側には「開・白・狭」で出してもらう必要があります（全台を一度に点ける時間が長くなるので、事前に卓オペレーターへ伝える）。

▲ 先頭へ

7. 実機が無いときの確かめ方（模擬）

7-1. 以前の Visualizer では「ずれ」が絵に出なかった

Visualizer は、rig.json にある1 つの姿勢で器具とビームを描きます。校正は「ビームが印に乗っているか」を見るので、そのままではビームは必ず印に乗り、ずれが絵に出ません。実機なら起きる「器具の姿勢が思っていたのと違う」を、絵だけでは再現できませんでした。

7-2. 数値での模擬: 真の姿勢で記録して、ずらして解く

1. 器具に真の姿勢（例: ピッチ 2°・ロール −1.5°）を入れる。
2. 校正シーンで、その真の姿勢のまま 5 点を記録する（光は印に乗る。観測は真の姿勢での Pan/Tilt）。
3. 姿勢をわざとずらす（位置・ヨー・傾きを 0 に戻す）。
4. calib solve 1 mode=full verify=P5 で解き、真の姿勢に戻るか見る。比較として mode=yaw も解く。
5. calib apply → rig list → calib undo で反映と取り消しも通す。

結果は 2 章のとおりです。数値としては正しく動きますが、この方法だけでは画面に「光が外れる」様子は出ません。

7-3. 「真の姿勢で描く」模擬（rig truth）

Visualizer だけが真の姿勢でビームと器具を描き、校正・Fast Focus・追尾は rig.json の信じている姿勢のまま計算する模擬です（命令 rig truth …・保存しない）。次のことが目に見えるようになります。

• 卓（信じている姿勢）が狙った点に対して、光は現実（真の姿勢）側へ外れて描かれる（1 章・2 章の絵）。
• 寄せて記録 → 解く → 反映したあと、外れていた光が印に戻る（下の比較）。
• 1 点オフセットで 1 点だけ合わせたとき、別の点では傾きぶん外れたままになるのが見える。

寄せの回数（2°／−1.5° の例を、光の落ち先と目印のずれ〔m〕で測ったもの。寄せるたびに小さくなります）:

これは模擬（Visualizer の絵）の中での話で、シミュレーターでどう見えるかの説明です。実機の挙動の確認ではありません。

7-4. 2 台構成（卓／現実）

もう 1 つの案は、2 台で役割を分ける構成です。卓は信じている姿勢（rig.json）で狙いを計算して Art-Net を出し、現実は Art-Net を受けて真の姿勢で光を描く Visualizer です。実機の構成（卓→Art-Net→器具）に近く、「現実側の姿勢」を卓の計算とは完全に別に持てます。1 台で足りる構成を先に使い、2 台構成は後にする想定です。

▲ 先頭へ

8. 今後

8-1. 状態（2026-10-23 夜）

実機では一度も確認していません。

8-2. 最優先の未確認つぶし: 実機 1 台を 2° 傾けて吊る

実機を 1 台、わざと 2° 傾けて吊り、次を測ります。

1. Pan/Tilt の符号と Tilt 0 の姿勢（LjStudio・GDTF の仮定を確かめる）
2. .spt／GDTF の可動角
3. 水準器で傾きを実測
4. マーカー 5 点で記録 → 4 未知数と 6 未知数で解く → 追尾で 3 点へ飛ばして着地のずれを巻尺で測る

合格線は 10 m 先で ±5 cm（CalibTrack の合格線）。実機の手当が決まるまで、「実機で通す」「tilt0」は未確認のままです。

8-3. その他の残り

• tilt0 の置き場（rig.json）と反映。
• kPan/kTiltを選択肢に入れるか（今は .spt／GDTF を信じる）。
• 残差の尺度を 1 つにする（LjStudio＝マーカー面の距離 m、CalibTrack＝方向ベクトル差。0.1° ≒ マーカー面で 11〜35 mm）。
• 高さの同じマーカーだけのときの警告。
• 初期値が大きく外れた場合の検証。

8-4. grandMA3・UE5 へ渡せる物

• 残る tilt0・kPan・kTilt（と pan0）は、DMX を出す側（LjStudio の追尾層）で打ち消す方針です。grandMA3／UE5 には位置と向き（MVR）だけを渡します。【推測】（提案段階）
• MVR の 3 軸書き出し・読み込みは実装済みです。grandMA3 との往復は「まだ確かめきっていない部分がある」と取扱説明書に明記されています。

▲ 先頭へ

9. 用語表

▲ 先頭へ