画像からの異常検知(統計モデル(PaDiM)・メモリバンク(PatchCore)・基盤モデル特徴(DINOv2最近傍法)の比較実験ツール)

【概要】

画像からの異常検知の実験資料。統計モデル(PaDiM)、メモリバンク(PatchCore)、基盤モデル特徴(DINOv2特徴を用いた最近傍法)の3方式を、学習済み特徴抽出器と正常画像の登録のみで実装し、ウェブカメラ画像で連続比較する手順・コード・考察の視点をまとめる。

本教材の目的は、論文ベンチマークの再現ではなく、正常状態を登録してから、その状態からの見た目の変化を異常マップ(画像を格子状の小領域に分割し、領域ごとの異常度を並べたもの)として観察することである。

【目次】

1. 目的と前提

テーマは画像からの異常検知である。対象は、物体、床面、机上、壁面などの静的な被写体とする。人間や動体そのものを検出することは目的としないため、動きの検出に依存しない外観ベースの異常検知手法を用いる。

ここでいう「異常」とは、「故障」「危険」「不良品」を直接意味するものではない。本教材では、正常画像として登録した状態から、画像上の見た目が変化した部分を異常として扱う。したがって、異物、傷、汚れだけでなく、照明の変化、カメラ位置の変化、影、反射、ピントの変化も異常として反応する場合がある。

運用上は、正常登録時と検知実行時のいずれにおいても、カメラと被写体をできるだけ静止させて使用する。人が写り込んだ場合、人を認識しているのではなく、登録時と異なる見た目の変化として反応する可能性がある。

1.1 この実験で確認できること

1.2 この実験だけでは確認できないこと

本教材では、その場で撮影した少数のラベル付きサンプルからAUROCと最適しきい値を求める機能を備える。ただし、これはMVTec ADのような標準データセットを用いた評価ではなく、同じ被写体・同じ登録条件のもとで方式間の反応を比べるための簡易的な数値化である。ラベル付きサンプルを集めていない段階では、異常マップの位置、色の変化、スコア比の増減を観察し、実験条件と対応づけて考察する。

2. 手法候補の一覧

静的な被写体の外観異常を検知できる画像異常検知手法について、代表的な以下の7件を候補とした。発表年や会議名は文献上の位置づけを示すための情報であり、本教材の実験では、実装対象の3方式のみを扱う。

No.手法名代表的な出典分類概要
1PaDiMICPR 2020/2021統計モデルパッチ(画像や特徴マップを格子状に分割した小領域)の位置ごとに正常特徴を多変量ガウス分布でモデル化し、マハラノビス距離(特徴の分散と相関を考慮して、平均からの離れ具合を測る距離)で異常度を算出する。
2PatchCoreCVPR 2022メモリバンク正常パッチ特徴をメモリバンク(正常時の特徴をそのまま保存しておく集合)化し、最近傍距離で異常度を算出する。コアセット選択(元の集合の広がりを保つように代表点を選び出す処理)によりメモリ量を削減する。
3EfficientADWACV 2024蒸留+オートエンコーダ軽量な教師・生徒構成(学習済みモデルの出力を教師として別のモデルを学習させる蒸留の構成)とオートエンコーダ(入力を低次元に圧縮してから復元するネットワーク)を組み合わせ、高速な異常検知を目指す手法である。
4AnomalyCLIPICLR 2024視覚言語モデル視覚言語モデル(画像と自然言語を共通の特徴空間で扱うモデル)CLIPを異常検知に適応させ、画像とテキスト表現を用いて異常を扱う手法である。
5AnomalyDINOWACV 2025基盤モデル特徴+最近傍DINOv2などの自己教師あり(正解ラベルを使わず、データ自身から学習の手がかりを作る学習方式)基盤モデル(大規模データで事前学習し、多様な課題に転用できるモデル)の特徴を用いて、正常参照画像とのパッチ特徴の違いから異常を検知する考え方を持つ。
6DinomalyCVPR 2025再構成(Transformer)DINOv2特徴の再構成に基づく異常検知手法である。
7INP-FormerCVPR 2025画像内プロトタイプ画像内の特徴からプロトタイプ(その領域を代表する特徴ベクトル)を作り、それを用いて異常を検知する考え方を持つ手法である。

3. 手法の選定

実行でき、仕組みを比較しやすく、追加のネットワーク学習を必要としない方式として、PaDiM、PatchCore、DINOv2特徴を用いた最近傍法の3方式を実装対象とした。

基準PaDiMPatchCoreDINOv2特徴を用いた最近傍法
基準1:教育的有用性ガウス分布とマハラノビス距離という統計の基礎概念で説明できる。「正常例を記憶し、最も近い正常例からの距離を測る」という最近傍法の考え方で説明できる。PatchCoreと同じ最近傍法の考え方を使いながら、特徴抽出器をCNNから基盤モデルへ変えたときの反応を比較できる。
基準2:実験しやすさtorchvisionのImageNet(大規模な画像分類用データセット)学習済みResNet-18を利用できる。PaDiMと同じResNet-18特徴を利用できる。torch.hubからDINOv2 ViT-S/14(画像を14×14画素のパッチに分割して扱うVision Transformerの小規模構成)を取得できる。
基準3:追加学習の有無対象データでのネットワーク学習は行わない。正常画像から統計量を推定する。対象データでのネットワーク学習は行わない。正常パッチ特徴のメモリバンクを作る。対象データでのネットワーク学習は行わない。正常パッチ特徴を参照メモリとして保持する。

選定しなかった候補の主な理由は次のとおりである。EfficientADやDinomalyは通常、対象データを用いた学習処理を含む。AnomalyCLIPは視覚言語モデルやプロンプト学習(モデルへ与える指示文の表現を学習で最適化する手法)の扱いが入り、単一ファイルでの体験実験にはやや重い。INP-Formerは有用な研究テーマであるが、実装規模や依存関係の点で、本教材の目的である「ウェブカメラで3方式をすぐ比較する実験」には採用しなかった。

なお、本教材のDINOv2特徴を用いた最近傍法は、AnomalyDINOの考え方に関連する「基盤モデル特徴+正常参照パッチとの最近傍比較」を体験するための実装である。AnomalyDINOの公式実装や論文実験の完全再現ではない。

4. プログラムの仕様

4.1 スコア比の重要な注意

スコア比は、各方式ごとに、較正用正常画像の最大スコアを100%として計算する相対値である。したがって、PaDiMのスコア比180%とPatchCoreのスコア比180%が、同じ大きさの異常を意味するわけではない。

方式間の数値の大小だけで優劣を判断してはいけない。同じ登録条件・同じ被写体・同じ変化に対して、異常マップの場所、広がり、スコア比の増減、判定の変化を観察する。

4.2 異常マップの重要な注意

異常マップはパッチ単位で計算する(PaDiM・PatchCoreは32×32、DINOv2特徴最近傍法はGPU使用時32×32・CPU使用時16×16)。既定では表示時に見やすくするための拡大とぼかしを行うが、「パッチ単位で表示」に切り替えると、ぼかしをやめてパッチをそのまま表示できる。いずれの表示でも、赤く表示された領域は「その付近の異常度が高い」ことを示すが、画素単位で正確な異常境界を示しているわけではない。

赤色は「絶対的に危険」という意味ではない。登録時に得た正常基準と現在のしきい値に対して、異常度が高いことを意味する。

5. 実行方法

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 ウィンドウは,マウスクリックでウィンドウをアクティブ(操作対象の状態)にしてからキーを押すと終了する

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

PyTorchとtorchvisionは、上記のPyTorchインストール手順で導入済みであることを前提とする。そのうえで、以下のライブラリを追加でインストールする。

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

次のコマンドを実行し、関連ライブラリをインストールする。

pip install -U --no-user opencv-python numpy pillow

実行

python anomaly_detection_demo.py

操作手順

  1. 初回実行時には学習済みモデルの自動ダウンロードが行われるため、インターネット接続が必要である。
  2. 左端のライブ映像を見ながら、カメラを静的な被写体に向ける。
  3. カメラと被写体をできるだけ固定し、照明が大きく変わらない状態にする。
  4. 「正常画像の登録」ボタンを押し、正常状態を撮影・登録する。続けて基準値の較正用画像が6枚撮影される。この間は、カメラと被写体を動かさない。
  5. 登録が完了すると、オレンジ色の「処理開始」ボタンが押せるようになる。これを押すと連続検知が始まる。
  6. 連続検知の実行中に、異物を置く、物体を少し動かす、照明を変えるなどの変化を加え、3方式の異常マップとスコア比がどのように変化するかを観察する。
  7. 「処理停止」ボタンで処理を止め、最後の検知結果を見比べる。被写体やカメラ位置を変えたときは、あらためて「正常画像の登録」からやり直す。

6. 調整可能なパラメータ

スライダー初期値(推奨)範囲説明
正常画像の枚数205〜50正常状態として登録する画像の枚数。多いほど正常状態のばらつきを反映しやすいが、登録時間とメモリ使用量も増える。このほかに、基準値の較正用として6枚が追加撮影される。
PaDiM 使用特徴次元数10010〜150ランダムに選ぶ特徴次元数。大きくすると情報量は増える可能性があるが、特徴次元数に比例して登録時と検知時の計算量が増える。正常画像の枚数が少ない場合、大きすぎる次元数では正則化(分散共分散に小さな値を加えて計算を安定させる処理)の影響が強くなる。
PatchCore サンプリング率10 %1〜10 %正常パッチ特徴のうち、メモリバンクに保持する割合。大きいほど正常パターンを多く保持できるが、登録時間と検知時の近傍探索コストが増える。保持数には内部的な上限があり、正常画像の枚数が多い場合はサンプリング率を上げてもメモリバンクの大きさが頭打ちになることがある。
PatchCore 近傍数 k11〜9異常度算出に用いる近傍数。k=1では最も近い正常パッチとの距離を用いる。kを大きくすると複数の近傍距離の平均を用いるため、局所的な外れ値への反応が変化する。
異常判定しきい値150 %100〜400 %較正用正常画像の最大スコアを100%とし、現在のスコア比がこの値を超えた場合に「異常あり」と判定する。異常マップの色もこのしきい値で正規化される。

DINOv2特徴を用いた最近傍法は、最近傍1点を用いる構成としているため、近傍数に関するスライダーは持たない。

このほかに、次のスイッチが連続処理中でも次のフレームから反映される。

7. 実装上の扱いと原論文との差異

本教材は、PaDiM、PatchCore、DINOv2特徴を用いた最近傍法の基本的な考え方を比較体験するための実装である。公式実装や論文実験の完全再現ではない。特に、ウェブカメラでリアルタイムに近い操作感を得るため、入力解像度、特徴マップの空間サイズ、特徴抽出器、画像レベルスコアの扱いを教材向けに調整している。

項目本実装での扱い説明
PaDiMResNet-18のlayer1〜3を使い、32×32のパッチ特徴にそろえた上で、パッチ位置ごとのガウス分布を推定する。位置ごとに「正常な特徴の分布」を持ち、そこから離れた特徴を異常とみなす方式として理解する。
PatchCoreResNet-18のlayer2〜3を使い、局所平均プーリング(近傍のパッチ特徴を平均してまとめる処理)を行った後、正常パッチ特徴をコアセット選択してメモリバンク化する。正常パッチを記憶し、最も近い正常パッチからの距離で異常度を測る方式として理解する。
DINOv2特徴最近傍法DINOv2 ViT-S/14のパッチ特徴を正規化し、正常画像の全パッチ特徴とのコサイン類似度(2つのベクトルのなす角の余弦で測る類似度)から異常度を計算する。PatchCoreと同じ最近傍法だが、特徴抽出器がCNNではなく自己教師あり基盤モデルである点に注目する。ただし、結果の差を特徴抽出器だけに原因づけすぎない。

7.1 注意すべき差異

8. Pythonコード全体

9. 実験のヒント

10. 実験の進め方

10.1 実験1:何も変えない場合

正常画像を登録した後、被写体に何も加えずに「処理開始」する。3方式のスコア比と異常マップを記録する。

この実験では、完全に同じ状態でもカメラノイズ、照明の揺れ、ピントの変化などにより、スコア比が100%を超える場合があることを確認できる。

10.2 実験2:異物を置く

正常状態を登録した後、画面内に小さな異物を置く。異物の場所に赤い領域が出るか、スコア比がどう変わるかを観察する。

異物の大きさや色を変えると、反応の強さが変化する場合がある。ただし、赤い領域の境界は画素単位で正確な輪郭ではない。パッチ単位(PaDiM・PatchCoreは32×32、DINOv2特徴最近傍法はGPU使用時32×32・CPU使用時16×16)の異常度を表示したものである。

10.3 実験3:被写体を少し動かす

異物を加えず、被写体やカメラ位置を少しだけ動かす。PaDiMはパッチ位置ごとに正常分布を持つため、位置ずれに反応しやすい場合がある。PatchCoreとDINOv2特徴最近傍法は、位置を固定せず近い特徴を探すため、PaDiMとは異なる反応を示す場合がある。

ただし、この結果だけから「どの方式が常に位置ずれに強い」とは結論しない。被写体、背景、照明、特徴抽出器、入力解像度の影響を受けるためである。

10.4 実験4:照明だけを変える

被写体を動かさず、照明の明るさや向きを少し変える。異物や傷がなくても、見た目が変われば異常として反応する場合がある。

この実験により、本教材の異常検知が「欠陥そのもの」を理解しているのではなく、「登録状態からの画像特徴のずれ」を見ていることを確認できる。

10.5 実験5:PatchCoreの近傍数kを変える

連続処理中にPatchCoreの近傍数kを1から9へ変える。同じ登録、同じ被写体、同じ異常に対して、PatchCoreの異常マップとスコア比がどう変化するかを観察する。

kを大きくすると、1つの最近傍だけではなく複数の近傍距離の平均を用いる。そのため、小さなノイズへの反応が弱くなる場合がある一方、小さな異常のスコアも下がる場合がある。

10.6 実験6:登録枚数を変える

正常画像の枚数を5枚、20枚、50枚などに変えて登録し直す。登録時間、スコア比、異常マップの安定性を観察する。

この実験では、正常画像を増やすと必ず精度が上がると決めつけない。正常画像の中に余計な変化が含まれると、それも正常として登録されるためである。

11. 記録表の例

「記録」ボタンを押すと、そのときの4画面・スコア・実験条件のメモがPNG画像とCSVファイルとしてanomaly_logsフォルダに自動保存される。以下の表は、この自動保存とは別に、実験の途中経過を手元でまとめるための記入例である。

実験条件 PaDiM スコア比・判定 PatchCore スコア比・判定 DINOv2特徴最近傍法 スコア比・判定 異常マップの観察 メモ
何も変えない 正常時の下限を確認
小さな異物を置く 異物の位置に反応したか
被写体を少し動かす 位置ずれへの反応
照明を変える 見た目の変化への反応

12. 考察ポイント

13. うまく動かないとき