追加機能メモ

[khsacc]

GUI修正メモ

[khsacc]

Detector configurations

• imageモードの時、imageとその他の領域の境目がわかりにくいので、枠線を付ける。
• imageモードの時、imageのない領域にはzoom in/outできないようにする

[khsacc]

Fitting

GUI

• fit peaksは入力ではなくプルダウンにする。
• デフォルトのrange startおよびrange endはそれぞれ現状表示されているスペクトルの最小最大値をはみ出さないようにする。

backend

• ピクセル数の多い分光器を使うと、ピーク探索がfailする確率が増えるので、smoothingするか、フィッティング成功している場合前の値を初期値として使うかなどしたほうがよさそう。

[khsacc]

Calibration

• 新しくデータを取得するのではなく、最新の表示されているデータを使うというオプション（ボタン）も作る。ボタンの位置はAcquireボタンの直下でよい。

[khsacc]

露光関係のバグ（基本対応済みだが、Andorのほうに残っている可能性があるので、それだけチェックしておく）

• 設定フラグのlost-update(取りこぼし) — camera_princeton.py:330-336で値を読み、ハードウェア適用後にNoneへクリア(350-351, 377-378, 408-409)しています。適用中(EM Gain切替は数百msかかり得る)に新しい要求が来ると、適用されないまま消えます。GUI経路はウィジェット無効化で守られていますが、api_mixin.py:51とcalibration_ui.py:295は無防備です。修正はロック内での swap-and-clear(new_exposure, self.new_exposure = self.new_exposure, None を読み出し時に)。Andor版(camera_andor.py:114-115)も同じパターンです。

• acquire_single_image の露光反映が sleep(0.1) 頼み — camera_princeton.py:567-570。run()ループが snap() 中(_hw_lock 保持で露光時間ぶんブロック)だと0.1秒では拾われず、古い露光時間のまま撮影されます。キャリブレーションUIとAPI経路の両方が該当。exposure_set_finished を threading.Event で待つ同期版が確実です。596行目の snap_timeout = self.current_exposure + 10 も同様に古い値を読み得ます。

• acquire_single_image 内の settings_changed がロックなし — 586行目の読み出しと593行目のクリアが非ロック。run()ループ側と競合すると、ROI更新のクリアが取りこぼされる/二重適用される可能性があります。run()側と同じくロック下で扱うべきです(Andor版も同様)。

• camera_princeton.py:492-493。whileループの外周で例外が起きるとprintしてスレッド終了し、GUIは通知を受けずに「測定中」のまま固まります。ここで acquisition_failed をemitすべきです。

[khsacc]

シャッターの制御

前提として同期型のシャッターがない機種もあるので、シャッターの動機制御についてはspectrometerConfig.jsonに書く仕様にしたほうが良い

そのうえで、18CのProEMの場合は、シャッターの同期を付けることでdarkを自動でとれるようになる。

pylablibにシャッター専用APIはないが、属性名文字列でのget/setで扱えるので、既存の _query_attribute_capability/_apply_attribute_value が使える。

• Shutter Timing Mode(Collection): Normal / Always Closed / Always Open / Open Before Trigger
• Shutter Opening Delay / Shutter Closing Delay(Range, ms)、Shutter Delay Resolution
• Internal/External Shutter Type(Vincent CS25/CS45等)、Internal/External Shutter Status(Not Connected / Connected / Overheated)
• Active Shutter(None / Internal / External)— ケーブル接続の外付けシャッターならここでExternalを選ぶ形

シャッターの挙動調査：

• _report_orientation_capability と同型の _report_shutter_capability() を接続時に呼び、上記属性群のexists/writable/現在値/候補値をログ。ProEM:1600²で Active Shutter が存在するか、External Shutter Status がConnectedになるかを実機確認

実装の草案：

• update_shutter_mode(mode) を既存フラグパターンで追加し、_apply_attribute_value("Shutter Timing Mode", mode) で適用・実値読み戻し・シグナル通知。Opening/Closing DelayはRange制約からUIの範囲を動的設定。
• UI: コンボボックス(Normal / Always Open / Always Closed)+遅延スピンボックス。debugはモック値。
• ダーク: acquire_backgroundの開始時にAlways Closedへ切替→取得→finallyで元モードへ復帰。
• Vincent系メカシャッターは開閉寿命と繰返しレート制限があるため、連続測定の既定はNormal(毎フレーム開閉)ではなくAlways Openにし、ダーク取得時のみAlways Closedにするのが安全（ProEMはフレームトランスファー型なので通常測定にシャッター開閉は必須ではあない）。
• 測定保存時にシャッターモードをメタデータ記録(file_io.py)。

[khsacc]

検出器温度読み取り

• 温度を読み取るときに一瞬露光する設定にしているのがあまり良いやり方ではない。PIの場合は温度だけ読み取ることができるがAndorでもできるか？→調査する
• PIのProEMのカメラの冷却機能にはLockedというstateがある。これを現状の実装は反映していない。
• Andorのカメラは温度を0.1 K刻みで返すが、PIは1 K刻みである。一応反映しておいたほうが良いかも。

[khsacc]

初期接続時の spectrometerConfig.json 生成

spectrometerConfig.jsonに入れるべき内容

• 分光器の型番、シリアルナンバー→2回目以降、もし違っていたら、このconfigはこの分光器用ではないと判断できる。
• カメラの型番、シリアルナンバー→2回目以降、もし違っていたら、このconfigはこの分光器用ではないと判断できる。
• シャッター制御の有無、シャッターの種類
• 読み出せる場合、gratingの情報
• その他、SDKから読める情報（要検討）