低照度を模擬した階調劣化と前処理が物体検出モデルの出力に与える影響の測定

【概要】

同一フレームに人工的な照度低下(ガンマ変換。画素値をべき乗して明るさを非線形に変える処理)と輝度補正の組合せを与え、物体検出結果の変化を測定する資料である。COCO(80種類の物体に注釈が付与された画像データセット)で学習済みのYOLO26nを、照度3水準×補正5列の計15条件に適用し、15条件の検出画像と測定値を5列×3行の格子に同時表示するプログラムの手順・コード・考察の視点をまとめる。各列に割り当てる補正手法はGUIから入れ替えられる。既定は補正なし・CLAHE・AGCWD・AGCWD→CLAHE・LIME型照明マップ推定の5種である。

【目次】

1. 目的と前提

目的は、同一フレームに人工的な照度低下(ガンマ変換)と輝度補正の組合せを与え、物体検出結果の変化を測定することである。実装は、COCO学習済みYOLO26nを、照度3水準×補正5列の計15条件に適用し、15条件の検出画像と測定値を5列×3行の格子に同時表示するPython/OpenCV/tkinterプログラムである。

15条件は1枚のフレームから生成され、同じ行の5列は同一の劣化画像を共有する。したがって列間の差は補正手法のみに、行間の差は照度のみに帰属する。15条件は常に同時に表示され、切り替えによって隠れるものはない。

第1列は基準条件を与えるため補正なしに固定する。第2列から第5列に割り当てる手法はGUIの「4. 列に割り当てる補正手法」で個別に選べる。既定の組合せは次のとおりである。

列既定の補正手法この列が担う問い
第1列補正なし(固定)照度低下そのものが検出結果に与える影響はどれだけか。全列共通の対照条件である。
第2列CLAHE(コントラスト制限付き適応ヒストグラム均等化)局所的なコントラスト強調で検出結果は回復するか。
第3列AGCWD(重み付け分布付き適応ガンマ補正)補正の強さを画像統計から自動決定する手法は、照度低下に追随できるか。
第4列AGCWD→CLAHE大域的トーン補正に局所コントラスト強調を重ねると、効果は加算的か。
第5列LIME型照明マップ推定(LIMEは低照度画像の補正手法の名称)CLAHEに依存しない補正経路で、どこまで回復するか。

行は上から、劣化ガンマ指数1.00(基準条件、元フレームと一致)、中段の値、下段の値である。

夜間の監視カメラ、悪条件下の自動運転、低照度の検査画像など、実環境では照度が保証されない場合がある。学習済みモデルがどの照度で機能を失い、前処理でどこまで取り戻せるかを数値で把握することは、実用システムにおける安全余裕の設定根拠となる。

2. 出力データ

出力は、15マスの格子画像、コンソールへの測定値、CSVファイル(measurement_log.csv、1条件1行)である。各条件について次の量を測る。

照度スイープを実行すると、上記に加えて劣化ガンマ指数ごとの参照F1・参照再現率・検出数の曲線、補正手法の順位、破綻ガンマ(参照F1が初めて0.50を下回る劣化ガンマ指数)、クラス別の参照再現率が得られる。これらはsweep_log.csvとsweep_class_log.csvへ記録できる。

3. 手法候補の一覧

照度の変化(入力側の要因)と輝度・コントラストの補正(前処理側の要因)が、物体検出モデル(測定器としての要因)の出力に与える影響を測る。したがって候補は、輝度・コントラストを操作する手法と、検出を担うモデルの両方から選定する。

No.手法名発表分類概要
1ヒストグラム均等化(HE)古典的手法大域的な輝度変換画像全体の輝度ヒストグラムを累積分布関数(ある値以下の画素が全体に占める割合を表す関数)によって写像し、階調の分布を一様に近づける。変換が画像全体で共通のため、画面の一部だけが暗い場合には、その部分の階調が広がらない。
2ガンマ変換古典的手法画素単位のべき乗変換正規化した画素値をべき乗して輝度を非線形に変換する。指数の与え方によって明るくも暗くもできる。単調増加の変換であるため画素値の大小関係は保たれる。256要素のルックアップテーブル(入力値と出力値の対応表)で計算できる。
3CLAHE(コントラスト制限付き適応ヒストグラム均等化)Zuiderveld, Graphics Gems IV, 1994局所的なヒストグラム変換画像を格子状のタイルに分割し、タイルごとにヒストグラム均等化を行う。クリップ制限値によってヒストグラムの高さを切り詰め、雑音の増幅量を制限する。タイル境界は双一次補間(周囲4点の値から線形に内挿する補間)で接続する。
4AGCWD(重み付け分布付き適応ガンマ補正)Huang ら, IEEE TIP, 2013大域的な統計依存トーン変換入力画像の輝度確率密度関数(各輝度値の出現割合を表す分布)を指数αで重み付けし、その累積分布 cdfw(l) から階調ごとのガンマ指数 γ(l)=1−cdfw(l) を定める。補正の強さを人が与える必要がない。
5MSRCR(色復元付きマルチスケールRetinex)Jobson ら, IEEE TIP, 1997Retinex理論に基づく分解Retinex理論(画像を照明成分と反射成分の積とみなす考え方)に基づき、広がりの異なる複数のガウシアン(ガウス関数の形をした平滑化フィルタ)で照明成分を推定し、反射成分を取り出す。色復元の項によって色の偏りを補正する。スケールと係数の設定を要する。
6LIMEGuo ら, IEEE TIP, 2017照明マップの推定各画素のRGB3成分の最大値から照明マップの初期値を求め、構造を保存する正則化(解が滑らかになるように制約を加える操作)によって平滑化したうえで、これを用いて除算し明るさを補正する。学習を行わず、最適化計算のみで動作する。
7ガイデッドフィルタHe ら, IEEE TPAMI, 2013構造保存平滑化局所窓ごとに案内画像(平滑化の手がかりとして与える画像)との線形関係を最小二乗法で当てはめ、その係数を平均して出力する。エッジを保存したまま平滑化できる。No.6の照明マップの平滑化に利用できる。
8Zero-DCE(AIモデル:DCE-Net)Guo ら, CVPR, 2020深層学習(正解画像を用いない学習)畳み込みニューラルネットワークが画素ごとの輝度調整曲線の係数を推定する。明るい画像と暗い画像の対を用いず、露出や色の恒常性(照明が変わっても物体の色の見えが保たれる性質)に関する制約を損失関数として学習する。推定した曲線を反復適用して補正する。
9Retinexformer(AIモデル)Cai ら, ICCV, 2023深層学習(Transformer)Retinex理論に基づく一段構成の枠組みに、照明を手がかりとする自己注意機構(入力要素どうしの関連の強さを計算して重み付けする仕組み)を組み合わせる。低照度画像復元のベンチマークで高い復元品質が報告されている。
10CoLIE(AIモデル)Chobola ら, ECCV, 2024深層学習(陰的神経表現)画像座標から輝度成分への写像を陰的神経表現(座標を入力として値を出力する小規模ネットワーク)で表し、画像1枚ごとに最適化する。学習済みデータセットへの依存が小さい一方、画像ごとに最適化計算を要する。
11YOLO26(AIモデル:yolo26nを含むn/s/m/l/xの5規模)Ultralytics, 2026(arXiv:2606.03748)NMSを用いない一段物体検出モデル既定の一対一ヘッド(1つの物体に検出枠を1つだけ対応づける出力部)により、NMS(非最大値抑制。重なり合う検出枠から代表を1つ残す後処理)を用いずに最大300個の検出を直接出力する。yolo26nのCOCO上のmAP50-95(物体検出の代表的な精度指標。IoUのしきい値を0.50から0.95まで変えて求めた検出精度の平均)は、既定の一対一ヘッドで40.1、NMSを併用する一対多ヘッドで40.9と報告されている。
12RT-DETR(AIモデル:rtdetr-l、rtdetr-x)Zhao ら(Baidu), CVPR, 2024Transformer型の物体検出モデルTransformer(自己注意機構を用いた深層学習の構造)に基づくDETR系(Transformerで物体検出を行うモデルの系列)の実時間検出器である。畳み込みによるバックボーン(画像から特徴を抽出する主要部)、ハイブリッドエンコーダ、IoUを考慮したクエリ選択(検出候補の絞り込み方)を用い、NMSを用いずに検出する。学習済み重みは規模lとxが配布されている。

4. コードで実装されている手法

本プログラムが実装している画像処理は、上表のNo.2(ガンマ変換)、No.3(CLAHE)、No.4(AGCWD)、No.6とNo.7の組合せ(LIME型照明マップ推定+ガイデッドフィルタ)を中核とし、これらに加えて理想逆ガンマ、固定ガンマ持ち上げ、百分位線形伸張、大域ヒストグラム平坦化、雑音抑制(バイラテラルフィルタ)+CLAHEの5手法を比較・切り分けのために備える。検出モデルは上表No.11(YOLO26、規模はn)である。役割は次のように分かれている。

4.1 他の候補手法と比べた特徴

4.2 使用しているAIモデルの所在

4.3 注意点(手法としての説明と、実装であるコードとの違い)

4.4 技術の限界

5. プログラムの概要

6. プログラム実行手順

Python 3.12 のインストール

Pythonのインストールを行い、Pythonのプログラムを実行する環境を整える。扱う環境は、Windows搭載パソコンである。金子研究室では、Python 3.12.10を推奨する。

[Windows での Python 3.12 のインストール手順を見るには、ここをクリック]

Windows での Python 3.12 のインストール

以下のいずれかの方法でPython 3.12をインストールする。Pythonがインストール済みの場合、この手順は不要である。

方法 1:winget によるインストール

【インストールコマンドの実行方法】

管理者権限でコマンドプロンプトを起動する(手順:Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。そして、コマンド全体をコマンドプロンプトにコピー&ペーストする。

--scope machine を指定することで、システム全体(全ユーザー向け)にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動するとPATHが反映される。

REM Python 3.12 をシステム領域にインストール
winget install --id Python.Python.3.12 -e --scope machine --silent --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_test=0 Include_pip=1 Include_launcher=1 InstallLauncherAllUsers=1 TargetDir=\"C:\Program Files\Python312\""
if not "%ERRORLEVEL%"=="0" ( color 0c & echo Python 3.12 のインストールに失敗しました & ping 127.0.0.1 -n 6 >nul & color )

REM Python と Scripts を PATH 先頭に追加
powershell -NoProfile -Command "$p='C:\Program Files\Python312'; $s=\"$p\Scripts\"; if(Test-Path $p){$k=[Microsoft.Win32.Registry]::LocalMachine.OpenSubKey('SYSTEM\CurrentControlSet\Control\Session Manager\Environment',$true); $c=$k.GetValue('Path','',[Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames); $t=$k.GetValueKind('Path'); $new=$c; if((';'+$new+';') -notlike \"*;$p;*\"){$new=$p+';'+$new}; if((';'+$new+';') -notlike \"*;$s;*\"){$new=$s+';'+$new}; if($new -ne $c){$k.SetValue('Path',$new,$t)}; $k.Close()}"

REM 現在のセッションにも反映(システムPATHを再取得して連結)
for /f "usebackq tokens=2,*" %A in (`reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path`) do set "PATH=%B"

REM pip / wheel の更新
python -m pip install --no-user -U pip wheel
if not "%ERRORLEVEL%"=="0" ( color 0c & echo pip / wheel の更新に失敗しました & ping 127.0.0.1 -n 6 >nul & color )

方法 2:インストーラーによるインストール

  1. Python公式サイト(https://www.python.org/downloads/)にアクセスし、「Download Python 3.x.x」ボタンからWindows用インストーラーをダウンロードする。
  2. ダウンロードしたインストーラーを実行する。
  3. 初期画面の下部に表示される「Add python.exe to PATH」にチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
  4. 「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号(例:Python 3.12.x)が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

Build Tools・CUDA Toolkit・PyTorch のインストール

本章では、C++ ビルドツール、NVIDIA CUDA Toolkit、PyTorch のインストールを行い、GPU を活用した機械学習プログラムを実行する環境を整える。扱う環境は、Windows 搭載パソコンである。

[Build Tools・CUDA Toolkit・PyTorch のインストール手順を見るには、ここをクリック]

Windows での Build Tools for Visual Studio 2026 のインストール

Build Tools for Visual Studio 2026 は、C++ ソースコードを Windows 用バイナリにコンパイルするための開発ツール群である。unsloth 等の一部 Python パッケージは、インストール時に C++ コードのビルドを必要とするため、これらのツールが必須となる。

以下のコマンドは、Build Tools が未インストールの場合は winget で新規インストールし、インストール済みの場合は setup.exe modify でコンポーネントを追加する(バージョンは変更しない)。

【インストールコマンドの実行方法】

管理者権限でコマンドプロンプトを起動する(手順:Windows キーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。そして、コマンド全体をコマンドプロンプトにコピー&ペーストする。

REM ============================================================
REM Visual C++ 再頒布可能パッケージ (VCRedist 2015-)
REM ============================================================
winget install --scope machine --id Microsoft.VCRedist.2015+.x64 -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/quiet /norestart"
if not "%ERRORLEVEL%"=="0" ( color 0c & echo VCRedist のインストールに失敗しました & ping 127.0.0.1 -n 6 >nul & color )

REM ============================================================
REM Visual Studio Build Tools + Desktop development with C++
REM (VCTools、MSBuildTools、CMake連携、Clang、Windows 11 SDK)
REM ============================================================
REM 進行中のインストーラーを停止(ロック競合回避。対象プロセスが存在しない場合は
REM taskkillがエラーを返すが、これは想定内であるため出力のみ抑制する)
taskkill /F /IM vs_setup.exe /T >nul 2>&1
taskkill /F /IM vs_installer.exe /T >nul 2>&1
taskkill /F /IM vs_installerservice.exe /T >nul 2>&1
taskkill /F /IM msiexec.exe /T >nul 2>&1

REM Build Tools + Desktop development with C++(VCTools)+ 追加コンポーネント(一括)
REM 未インストール時: winget で新規インストール
REM インストール済み時: setup.exe modify でコンポーネント追加(バージョンは変更しない)
winget list --id Microsoft.VisualStudio.BuildTools 2>nul | findstr /i "BuildTools" >nul 2>&1
if %ERRORLEVEL% EQU 0 (
    for /f "usebackq delims=" %P in (`"C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe" -products Microsoft.VisualStudio.Product.BuildTools -property installationPath`) do start /wait "" "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "%P" --add Microsoft.VisualStudio.Workload.VCTools --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100 --add Microsoft.VisualStudio.Component.VC.v143.x86.x64 --includeRecommended --quiet --norestart --nocache
    if not "%ERRORLEVEL%"=="0" ( color 0c & echo Build Tools のコンポーネント追加に失敗しました & ping 127.0.0.1 -n 6 >nul & color )
) else (
    winget install --scope machine --id Microsoft.VisualStudio.BuildTools -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "--quiet --wait --norestart --nocache --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100 --add Microsoft.VisualStudio.Component.VC.v143.x86.x64"
    if not "%ERRORLEVEL%"=="0" ( color 0c & echo Build Tools のインストールに失敗しました & ping 127.0.0.1 -n 6 >nul & color )
)

REM BuildTools のインストールパスを vswhere.exe で取得(メジャーバージョンに依存しない)
set "VSWHERE=C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe"
set "BT_PATH="
for /f "usebackq delims=" %P in (`"%VSWHERE%" -products Microsoft.VisualStudio.Product.BuildTools -property installationPath`) do set "BT_PATH=%P"
if not defined BT_PATH ( color 0c & echo Build Tools のインストールパスを取得できませんでした & ping 127.0.0.1 -n 6 >nul & color )

REM 破損時の修復(任意、動作がおかしくなった場合)
REM if defined BT_PATH "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" repair --installPath "%BT_PATH%" --quiet --norestart
REM 導入確認(インストールパスが表示されれば正常)
"%VSWHERE%" -products * -requires Microsoft.VisualStudio.Workload.VCTools -property installationPath

上記のコマンドでは、Build Tools 本体と Visual C++ 再頒布可能パッケージをインストールし、続いて以下のコンポーネントを追加している。

追加のコンポーネントが必要になった場合は Visual Studio Installer で個別にインストールできる。

Windows での NVIDIA CUDA Toolkit のインストール

NVIDIA CUDA Toolkit は、NVIDIA GPU 上で計算を行うためのコンパイラ・ライブラリ群である。PyTorch や vLLM 等が GPU を利用するために必要となる。GPU を使用しない場合、この手順は不要である。

前提条件:NVIDIA GPU、NVIDIA ドライバ、Build Tools for Visual Studio もしくは Visual Studio が必要である。

インストール中の注意:他のウインドウは閉じておくこと。

【インストールコマンドの実行方法】

管理者権限でコマンドプロンプトを起動する(手順:Windows キーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。そして、コマンド全体をコマンドプロンプトにコピー&ペーストする。

REM ============================================================
REM CUDA 12.8
REM ============================================================
winget install --scope machine --id Nvidia.CUDA --version 12.8 -e --silent --disable-interactivity --force --uninstall-previous --accept-source-agreements --accept-package-agreements --override "-s -n"
if not "%ERRORLEVEL%"=="0" ( color 0c & echo CUDA のインストールに失敗しました & ping 127.0.0.1 -n 6 >nul & color )

REM 統合用ファイルのコピー
if exist "C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8\" (
    xcopy "C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8\extras\visual_studio_integration\MSBuildExtensions\*.*" "c:\Program Files\Microsoft Visual Studio\18\Community\MSBuild\Microsoft\VC\v180\BuildCustomizations\" /Y
    xcopy "C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8\extras\visual_studio_integration\MSBuildExtensions\*.*" "C:\Program Files (x86)\Microsoft Visual Studio\18\BuildTools\MSBuild\Microsoft\VC\v180\BuildCustomizations\" /Y
    xcopy "C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8\extras\visual_studio_integration\MSBuildExtensions\*.*" "C:\Program Files (x86)\Microsoft Visual Studio\18\BuildTools\MSBuild\Microsoft\VC\v170\BuildCustomizations\" /Y /I
) else (
    echo CUDA v12.8 のディレクトリが存在しません。
    ping 127.0.0.1 -n 6 >nul
)

REM 環境変数TEMP, TMPの設定(一時ファイルの保存先を短いパスに変更)
set "TEMP=C:\TEMP"
set "TMP=C:\TEMP"
powershell -NoProfile -Command "$k=[Microsoft.Win32.Registry]::LocalMachine.OpenSubKey('SYSTEM\CurrentControlSet\Control\Session Manager\Environment',$true); foreach($n in @('TEMP','TMP')){ $t=[Microsoft.Win32.RegistryValueKind]::ExpandString; if($k.GetValueNames() -contains $n){ $t=$k.GetValueKind($n) }; $k.SetValue($n,'C:\TEMP',$t) }; $k.Close()"
reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v TEMP
reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v TMP

環境変数 TEMP および TMP を C:\TEMP に変更しているのは、後続のインストール処理で長いパス名や空白を含むパス名がエラーの原因となる場合があるためである。

Windows での PyTorch のインストール

https://pytorch.org のインストールガイドに従い、自環境の CUDA バージョンに対応したコマンドを取得して実行する。CUDA バージョンは以下で確認できる。

nvcc --version

管理者権限でコマンドプロンプトを起動し、以下を実行する。cu128 は CUDA 12.8 用のタグである。CUDA バージョンが異なる場合は、上記公式サイトで該当するタグを確認し、URL 末尾の cu128 を置き換えること。

REM numpy と PyTorch(CUDA 12.8 対応 wheel)、pip キャッシュを全削除
set "CUDA_TAG=cu128"
pip install --no-user -U numpy torch torchvision torchaudio --index-url https://download.pytorch.org/whl/%CUDA_TAG%
if not "%ERRORLEVEL%"=="0" ( color 0c & echo numpy / PyTorch のインストールに失敗しました & ping 127.0.0.1 -n 6 >nul & color )

Python の開発環境 Visual Studio Code のインストールと Python 用の設定

Python の開発環境Visual Studio Code(プログラムを編集するソフトウェア。以下、VS Code)を整える。

[Windows での Visual Studio Code のインストールと Python 用の設定手順を見るには、ここをクリック]

Windows での Visual Studio Code のインストールと Python 用の設定手順

1. VS Code と拡張機能のインストール

以下のコマンドにより,既存の VS Code を削除し,全ユーザー共有の設定で再インストールしたうえで,拡張機能(VS Code に機能を追加するソフトウェア)をまとめて導入する.

【インストールコマンドの実行方法】

管理者権限でコマンドプロンプトを起動する(手順:Windows キーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。そして,コマンド全体をコマンドプロンプトにコピー&ペーストする。

インストールコマンド


REM ============================================================
REM Microsoft Visual Studio Code
REM ============================================================
REM Build Tools + Desktop development with C++(VCTools)+ 追加コンポーネント(一括)
REM 未インストール時: winget で新規インストール
REM インストール済み時: setup.exe modify でコンポーネント追加(バージョンは変更しない)
winget list --id Microsoft.VisualStudio.BuildTools 2>nul | findstr /i "BuildTools" >nul 2>&1
if %ERRORLEVEL% EQU 0 (
    for /f "usebackq delims=" %P in (`"C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe" -products Microsoft.VisualStudio.Product.BuildTools -property installationPath`) do start /wait "" "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "%P" --add Microsoft.VisualStudio.Workload.VCTools --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100 --add Microsoft.VisualStudio.Component.VC.v143.x86.x64 --includeRecommended --quiet --norestart --nocache
    if not "%ERRORLEVEL%"=="0" ( color 0c & echo Build Tools のコンポーネント追加に失敗しました & ping 127.0.0.1 -n 6 >nul & color )
) else (
    winget install --scope machine --id Microsoft.VisualStudio.BuildTools -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "--quiet --wait --norestart --nocache --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100 --add Microsoft.VisualStudio.Component.VC.v143.x86.x64"
    if not "%ERRORLEVEL%"=="0" ( color 0c & echo Build Tools のインストールに失敗しました & ping 127.0.0.1 -n 6 >nul & color )
)

REM 全ユーザー共有の拡張機能フォルダ
if not exist "C:\ProgramData\vscode-extensions" mkdir "C:\ProgramData\vscode-extensions"
icacls "C:\ProgramData\vscode-extensions" /grant "Everyone:(OI)(CI)M" /T

REM スタートメニューのショートカットを --extensions-dir 付きで再作成
if exist "C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code" rmdir /s /q "C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code"
if exist "C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code.lnk" del "C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code.lnk"
powershell -NoProfile -Command "$s=New-Object -ComObject WScript.Shell; $lnk=$s.CreateShortcut('C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code.lnk'); $lnk.TargetPath='C:\Program Files\Microsoft VS Code\Code.exe'; $lnk.Arguments='--extensions-dir \"C:\ProgramData\vscode-extensions\"'; $lnk.Save()"
REM ショートカットの検証
powershell -NoProfile -Command "$s=New-Object -ComObject WScript.Shell; $lnk=$s.CreateShortcut('C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code.lnk'); Write-Host 'TargetPath:' $lnk.TargetPath; Write-Host 'Arguments:' $lnk.Arguments"

REM ファイル / フォルダ右クリックの「Code で開く」を登録
reg add "HKLM\SOFTWARE\Classes\*\shell\VSCode\command" /ve /d "\"C:\Program Files\Microsoft VS Code\Code.exe\" --extensions-dir \"C:\ProgramData\vscode-extensions\" \"%1\"" /f
reg add "HKLM\SOFTWARE\Classes\Directory\shell\VSCode\command" /ve /d "\"C:\Program Files\Microsoft VS Code\Code.exe\" --extensions-dir \"C:\ProgramData\vscode-extensions\" \"%1\"" /f
reg add "HKLM\SOFTWARE\Classes\Directory\Background\shell\VSCode\command" /ve /d "\"C:\Program Files\Microsoft VS Code\Code.exe\" --extensions-dir \"C:\ProgramData\vscode-extensions\" \"%V\"" /f

REM --extensions-dir 付きで起動する code.cmd ラッパを作成
REM (%* を echo で書くと対話的 cmd で失われるため、PowerShell で [char]37+'*' を書き出す)
powershell -NoProfile -Command "$pct=[char]37; $q=[char]34; $c='@echo off'+[char]13+[char]10+$q+'C:\Program Files\Microsoft VS Code\bin\code.cmd'+$q+' --extensions-dir '+$q+'C:\ProgramData\vscode-extensions'+$q+' '+$pct+'*'+[char]13+[char]10; [IO.File]::WriteAllText('C:\ProgramData\vscode-extensions\vscode.cmd',$c,[Text.Encoding]::ASCII)"

REM 拡張機能のインストール
set "CODE=C:\Program Files\Microsoft VS Code\bin\code.cmd"
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --uninstall-extension GitHub.copilot
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --uninstall-extension GitHub.copilot-chat
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension ms-python.python
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension ms-python.vscode-pylance
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension ms-python.debugpy
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension MS-CEINTL.vscode-language-pack-ja
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension saoudrizwan.claude-dev
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension rust-lang.rust-analyzer
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension tamasfe.even-better-toml
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension anthropic.claude-code
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension almenon.arepl
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --list-extensions --show-versions

REM settings.json を作成(自動更新オフ、Python、Claude Code 設定)
if not exist "%APPDATA%\Code\User" mkdir "%APPDATA%\Code\User"
python -c "import json,os;data={'update.mode':'none','update.enableWindowsBackgroundUpdates':False,'extensions.autoUpdate':False,'python.defaultInterpreterPath':r'C:\Program Files\Python312\python.exe','claudeCode.environmentVariables':[{'name':'ANTHROPIC_API_KEY','value':'not-needed'},{'name':'ANTHROPIC_AUTH_TOKEN','value':'ollama'},{'name':'ANTHROPIC_BASE_URL','value':'http://localhost:11434'},{'name':'ANTHROPIC_MODEL','value':'glm-4.7-flash'},{'name':'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC','value':'1'}]};p=os.path.join(os.environ['APPDATA'],'Code','User','settings.json');open(p,'w',encoding='utf-8').write(json.dumps(data,indent=4));print('Done:',p)"

REM 自動更新の抑止ポリシー(settings.json に加えて、レジストリ側でも明示的にオフ)
reg add "HKLM\SOFTWARE\Policies\Microsoft\VSCode" /v "UpdateMode" /t REG_SZ /d "none" /f
echo === セットアップ完了 ===

2. Python インタプリタの選択

同一マシンに複数の Python がインストールされている場合,VS Code で使用する Python 本体(インタプリタ:Python プログラムを解釈・実行するソフトウェア)を選択する必要がある.

  1. コマンドパレット(コマンド名で機能を呼び出す VS Code の入力欄)を開く(Ctrl+Shift+P)
  2. Python: Select Interpreter と入力する
  3. 表示される一覧から,使用する Python(例:C:\Program Files\Python312\python.exe)を選択する.

Python プログラム実行手順

[Windows での Python プログラム実行手順を見るには、ここをクリック]

Windows での Python 実行手順(Visual Studio Codeを使用)

プログラムファイルの作成と保存

  1. 左サイドバーの「エクスプローラー」アイコン(Ctrl+Shift+E)をクリックする
  2. 「NO FOLDER OPENED」(作業対象フォルダが未選択の状態)と表示される場合は,「Open Folder」をクリックし,プログラムを保存するフォルダを選択する

    続いて「フォルダを信用するか」を確認する画面(フォルダ内のコードを実行してよいか確認する VS Code の仕組み)が表示されるので,チェックして Yes を選択する

  3. フォルダ名の右側に表示される「新しいファイル」アイコンをクリックする
  4. ファイル名(例:aitask.py.ファイル名は何でも良い)を入力し Enter を押す.拡張子は .py(Python ファイルを示す拡張子)とする
  5. 実行したいコードを選択し,Ctrl+C でコピーする.VS Code のエディタ領域に Ctrl+V で貼り付ける
  6. Ctrl+S で保存する

プログラムの実行

  1. エディタ右上の三角形「▷」アイコン(Run Python File:現在開いている Python ファイルを実行するボタン)をクリックする.または,エディタ上で右クリックし「ターミナルで Python ファイルを実行」を選択する
  2. VS Code 下部のターミナル(コマンドの入出力を表示する画面)に,実行結果(print 関数の出力等)が表示される
  3. tkinter(Python 標準の GUI ライブラリ)のファイル選択ダイアログを使うプログラムを実行した場合は,ダイアログが開くので対象画像を選択する
  4. VS Code 下部のターミナルで実行結果を確認する.OpenCV ウィンドウ(OpenCV が画像を表示するために開く専用ウィンドウ)が開いた場合はそちらも確認する.OpenCV ウィンドウは,マウスクリックでウィンドウをアクティブ(操作対象の状態)にしてからキーを押すと終了する

必要なライブラリのインストール

  1. 管理者権限でコマンドプロンプトを起動する (手順:Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」)。
  2. 次のコマンドを実行し、関連ライブラリを導入または更新する。YOLO26に対応したバージョンが必要であり、対応していないバージョンではyolo26n.ptを解決できない。
    pip install -U --no-user ultralytics
    

実行手順

  1. 下記のプログラムをprogram.pyなどの名前で保存し、実行する。初回実行時は学習済み重みの自動ダウンロードが行われるため、インターネット接続が必要である。進捗はコンソールに表示される。
  2. ウィンドウが開いたら、「1. 映像入力源」でカメラデバイスまたは動画ファイルを選ぶ。カメラが1台の場合、デバイス番号は0である。
  3. 他のパラメータは初期値のままでよい。値の変更は開始後にも行える。
  4. 「撮影開始」を押す。カメラを使う場合は、COCOの80クラスに含まれる物体(person、chair、backpack、bottle、laptopなど)が画面に入るようにカメラを向ける。
  5. 左上のマス(R1C1)で目的の物体が検出されていることを確認する。これは元フレームそのものであり、参照集合を与える基準条件である。
  6. 「静止フレーム保持」にチェックを入れる。以降は同じフレームが繰り返し処理されるため、被写体の動きを排除してパラメータだけを変えられる。
  7. 第1列を上から下へ見て、劣化ガンマ指数の低下に伴う検出数と参照再現率の変化を追う。
  8. 同じ行を左から右へ見て、第2〜5列に割り当てた補正手法による差を確認する。割り当てる手法は「4. 列に割り当てる補正手法」で入れ替えられる。
  9. 「撮影停止」で停止する。ウィンドウを閉じると終了する。

処理が重い場合はimgszを320に下げると1フレームあたりの処理時間が短くなる。ただしimgszは検出結果そのものに影響するため、1回の観察の中では固定する。

7. GUIで設定可能なパラメータ

最上行の劣化ガンマ指数は基準条件として1.00に固定している。それ以外はすべて画面上で変更でき、処理中の変更は次のフレームから反映される。

No.名称コード上の識別子初期値範囲(刻み)説明
1映像入力源の種別source_variableカメラデバイスカメラデバイス/動画・画像ファイル処理対象の映像の取得元である。動画・画像ファイルを選ぶ場合は、あらかじめ「選択」ボタンでファイルを指定する。
2カメラデバイス番号camera_index_variable00〜7(1)OpenCVがカメラを識別する番号である。カメラが1台のときは0を指定する。
3劣化ガンマ指数(中段 R2)gamma_mid_variable0.600.05〜1.00(0.05)中段の行に与える照度低下の強さである。1.00で元フレームと一致し、値を下げるほど暗くなる。
4劣化ガンマ指数(下段 R3)gamma_low_variable0.300.05〜1.00(0.05)下段の行に与える照度低下の強さである。中段より小さい値を与えると、上段から下段へ向かって単調に暗くなる。
5光子雑音を加えるかどうかnoise_enabled_variable無効有効/無効照度の劣化にショットノイズの増加分を付加するかどうかである。有効にすると、劣化ガンマ指数が小さいほど雑音が強くなる。
6光子数の指数 log10(N0)photon_exponent_variable3.402.00〜5.00(0.10)基準となる光子数N0の常用対数である。大きくするほど雑音が弱くなる。光子雑音を有効にしたときのみ効く。
7YOLO26n 確信度しきい値 confconf_variable0.250.05〜0.90(0.05)検出として採用する確信度の下限である。下げると検出数と誤検出がともに増える。条件間の比較を成立させるため、1回の観察の中では固定する。
8YOLO26n 推論入力の一辺 imgsz(画素)imgsz_variable640320〜960(32)推論の際に画像を調整する一辺の画素数である。小さくすると1フレームの処理時間が短くなる一方、画面内で小さく写る物体の検出が難しくなる。刻みを32としているのは、モデルの構造上、入力の一辺が32の倍数である必要があるためである。
9参照集合との一致判定 IoUしきい値iou_variable0.500.30〜0.90(0.05)基準条件の検出と当該条件の検出を同一物体とみなすためのIoUの下限である。上げるほど枠の位置ずれに厳しくなり、参照再現率と参照適合率が下がる。
10第2〜5列に割り当てる補正手法column_variablesCLAHE、AGCWD、AGCWD→CLAHE、LIME型照明マップ推定手法一覧から選択各列に割り当てる補正手法をコンボボックスで選ぶ。第1列は基準条件のため常に「補正なし」に固定する。
11CLAHE クリップ制限値 clipLimitclip_limit_variable2.00.5〜8.0(0.5)タイルごとのヒストグラムを切り詰める高さである。大きくするとコントラストの拡大量が増え、同時に暗部の雑音の増幅量も増える。CLAHEを含む列に適用される。
12CLAHE タイル分割数(縦横共通)tile_grid_variable82〜16(1)局所ヒストグラムを計算する格子の分割数である。大きくすると1タイルが小さくなり、局所的な明暗差に追随する度合いが増す。CLAHEを含む列に適用される。
13AGCWD 重み付け指数 αagcwd_alpha_variable0.500.10〜1.00(0.05)輝度確率密度関数を重み付けする際のべき指数である。1.00に近いほど元の分布に近く、小さいほど分布が平坦化される。原論文の推奨値は0.5である。AGCWDを含む列に適用される。
14照明マップ調整指数 γLlime_gamma_variable0.800.40〜1.00(0.05)推定した照明マップTに対して T←TγL を施す際の指数である。1.00未満にすると照明マップの値が大きくなるため除算による増幅が抑えられる。LIME型の列に適用される。
15ガイデッドフィルタ半径 r(画素)lime_radius_variable153〜45(2)照明マップを構造保存平滑化する際の局所窓の半径である。大きくすると照明マップが滑らかになり、物体の輪郭が照明成分に混入しにくくなる一方、細かな照明むらへの追随が鈍る。正則化パラメータεはコード中の定数(0.01)である。LIME型の列に適用される。
16固定ガンマ持ち上げの γboost_gamma_variable0.500.20〜1.00(0.05)劣化γを知らずに一定のガンマで持ち上げる素朴な補正の指数である。「固定ガンマ持ち上げ」の列に適用される。
17雑音抑制の色差 σdenoise_sigma_variable405〜120(5)「雑音抑制→CLAHE」の列で用いるバイラテラルフィルタの色差方向の広がりである。大きくするほど平坦部の雑音抑制が強くなる。
18コンソールへの出力console_output_variable有効有効/無効記録対象フレームの測定値をコンソールへ出力する。
19CSVファイルへの記録csv_output_variable無効有効/無効有効にすると、プログラムファイルと同じディレクトリのmeasurement_log.csvへ1条件1行で追記する。文字コードはUTF-8(BOM付き。BOMはファイル先頭に置く文字コード識別用の印)であり、表計算ソフトでそのまま開ける。
20記録間隔(フレーム)record_interval_variable201〜200(1)記録を行う間隔である。新しく取り込んだフレームの番号がこの値の倍数になったときに記録する。
21静止フレーム保持hold_frame_variable無効有効/無効有効にすると、新しいフレームを取得せず、直前に取得したフレームを繰り返し処理する。被写体の動きを排除してパラメータの効果だけを観察するための機能である。

このほか「7. 照度スイープ」パネルで、劣化ガンマ指数の下限(既定0.10、範囲0.05〜0.95)、刻み幅(既定0.05、範囲0.01〜0.20)、繰り返しフレーム数(既定1、範囲1〜30)を設定し、現在のフレームに対する自動測定を実行できる。結果はsweep_log.csvとsweep_class_log.csvへ保存できる。

8. プログラムコード

9. ヒントと考察ポイント

9.1 ヒント

9.2 実験のバリエーション

以下は列の割り当てが既定(第2列CLAHE、第3列AGCWD、第4列AGCWD→CLAHE、第5列LIME型照明マップ推定)である場合の例である。

9.3 考察ポイント