野生動物映像のオープンデータ41件と YOLOE-26 検出実験環境

プログラムの動作の様子の動画:[動画]

実行ファイル:[exe]

実行ファイル(exe)は、Chrome または Firefox を用いてダウンロードすることを推奨。初回実行時に、SmartScreenの「WindowsによってPCが保護されました」の警告画面が出ます。警告画面で「詳細情報」をクリック、「実行」をクリックで続行できます。

説明資料: [PDF], [PPTX] , [動画](クリックして再生開始), クレジット:動画は「VOICEVOX:青山龍星」、「Vrew」、「Gemini」を用いて作成

本資料とコードの作成にAIを使用。参考プロンプト: prompt.md (実際にはこのプロンプトを変更したり、追加のプロンプトを与えている場合がある)

このプログラムの理念と目的

本プログラムは、野生動物の映像に対して YOLOE-26 による動物検出を行い、夜間映像向けの画像補正が検出結果をどのように変えるかを、補正無と補正有の並列比較によって観察するための研究・教育用の実験環境である。入力には、公開データの野生動物映像 41 件、利用者の動画ファイル、PC に接続したカメラを用いることができる。AI の推論はすべて PC 内で実行する。YOLOE-26 は、開放語彙(学習時に定めた少数のクラスに限らず、多数の語で物体を名指しできる)の物体検出・インスタンス分割(物体ごとの領域の推定)モデルである。

物体検出 AI の出力は、映像の明るさ、画像補正、検出閾値などの条件によって変わるが、検出結果だけを見ても、どの条件がどう影響したかは分からない。本プログラムの目的は、条件と結果の関係を利用者自身がスライダ操作で確かめられること、および結果の算出手順を第三者が追跡・再現できることである。

本プログラムは正解ラベル(人手による正解の注釈)を持たないため、検出精度(適合率・再現率・mAP)は算出しない。得られるのは、検出数や信頼度スコアなどの記述統計と、条件による変化の観察結果である。

特徴

プロンプト入力を必要としない開放語彙モデルを用いる。 YOLOE-26 のプロンプトフリー重みは、各候補領域を内蔵語彙 4,585 語と照合してクラス名を付けるため、利用者が検出対象の語を入力する必要はない。本プログラムは、スコア最大のクラスが動物を表す 274 語のいずれかである検出を「動物検出」として扱い、矩形・クラス名・信頼度スコア・インスタンスマスク(物体の領域)を表示する。

公開データ 41 件のカタログを内蔵する。 内容は Wikimedia Commons の 33 件(うち日本で撮影されたもの 4 件)と、Zenodo の熱赤外スコープによる夜間映像 8 件である。実行時に公開元から自動取得し、バイト数と公開ハッシュ値が一致したデータだけを使用する。

補正パラメータと検出閾値を自動で探索する。 正解ラベルのない映像でも条件を選べるよう、検出の整合性を表す独自の代理指標 Q を用いて、10 種類の補正候補と 8 段階の閾値の中から Q が最大となる組を選ぶ。Q は検出精度ではなく、Q による選択が検出精度を高める保証はない。

AI の算出過程を可視化する。 モデルへ実際に入力された画像、モデル内部の特徴マップ、フレームごとの最大信頼度スコアの推移、自動探索の全候補の指標値を表示する。

結果を記録し、再現できる。 乱数を使用しないため、同じ入力・同じ重み・同じ演算装置では同じ結果になる。解析条件とソフトウェアの版は出力ファイルに記録される。デモ動画の出現記録は、生物多様性情報の国際標準である Darwin Core 形式の CSV で出力できる。

機能概要

処理には、次の画像補正、検出閾値、代理指標を用いる。

Q = D × (C + S + T) / 3

D は評価に用いたフレームのうち τ 以上の検出が 1 つ以上あるものの割合、C は τ 以上の検出の平均信頼度スコアである。S(空間的整合性)は、矩形の面積が画像の 0.01–90 % にあり、より高スコアの検出との重なり(IoU)が 0.7 未満である検出の割合である。T(時間的一貫性)は、約 0.2 秒離れたフレームの対(少なくとも一方に検出があるもの)ごとに、IoU 0.3 以上の検出を一対一に対応づけた数を検出数の多い方で割った値の平均である。Q は検出の整合性の目安であり、検出精度ではない。

動画は次の順序で処理される。

  1. 取得と完全性照合(デモ動画のみ):公開元から受信した動画のバイト数と公開ハッシュ値(Wikimedia Commons は SHA-1、Zenodo は MD5)が一致した場合に限り保存する。
  2. 全フレーム復号検証:全フレームを 2 回復号し、フレーム数と全画素の CRC-32 が一致することを確認する。これは復号結果が再現することの確認であり、符号化前の原映像との同一性を示すものではない。
  3. 自動探索:動画長の 20 / 40 / 60 / 80 % の位置から約 0.2 秒間隔で 3 枚ずつ、計 12 枚のフレームを取り出す。補正候補は、CLAHE の強さ 3 水準(なし・2・4)とガンマ γ 3 水準(1・0.8・0.6)の組合せ 9 種と、そのうち Q が最大の候補に平滑化を加えた 1 種の計 10 種である。各候補について τ を 0.05–0.50 の 8 段階から選び、Q が最大となる補正と τ の組を採用する。補正無の条件も同じ規則で τ を選ぶ。既定では、夜間に分類されたデモ動画だけが補正探索の対象であり、それ以外の動画では補正有は補正無と同一になる。
  4. 動物検出:解析フレーム(既定は全フレーム)ごとに、補正無の画像と補正有の画像をそれぞれ YOLOE-26 で推論する。
  5. 保存と表示:結果を条件ごとに保存し、補正無と補正有を左右に並べて表示する。同じ条件で再実行した場合は、保存済みの結果を読み込む。

カメラ入力では、最新のフレームに対して推論を繰り返し、結果をリアルタイムで表示する。推論が取得より遅い場合、間のフレームは処理されない。カメラでは自動探索を行わず、スライダの値を用いる。

出力されるファイル(プログラムと同じフォルダ配下の outputs フォルダ)は次のとおりである。

ファイル内容
occurrences_darwin_core.csvデモ動画 41 件の出現記録(Darwin Core 形式)
analysis.json解析条件、ソフトウェアの版、検証結果、フレームごとの最大信頼度スコアと検出数
contact_sheet.png検証済みデモ動画の中央時刻フレームの一覧画像
camera_日時.csv / .jsonカメラで処理した各フレームの取得時刻・処理時間・検出数と、カメラ設定・解析条件(カメラ停止時に保存)

画面操作およびキー操作

画面は 5 つのタブで構成される。「補正無」は元の画像、「補正有」は夜間映像向けの画像補正を施した画像を指す。青いボタンは動画の取得・検証、緑のボタンは AI 解析とカメラの開始・停止を行う。処理中は右上の「処理を中止」で中止でき、不完全なファイルや結果は残らない。

メイン(検出・比較)タブ

入力源:「デモ動画」「利用者動画」「カメラ」から選ぶ。デモ動画と利用者動画は、緑の「▶ 取得・検証・AI 解析を実行」を押すと、未取得なら取得し、検証の後に解析する。カメラは「▶ カメラ開始」で開始し、同じボタン(「■ カメラ停止」)で停止する。停止時に、処理した各フレームの記録が outputs フォルダへ保存される。

解析条件:変更した場合は実行ボタンで再実行する。

調整:「自動探索の結果を使う」がオンのときは、解析時に自動で選ばれた補正と検出閾値 τ が使われる。オフにすると、次の値を手動で変更できる。カメラでは常にスライダの値が使われる。

項目範囲意味
検出閾値 τ0.05–0.95この値以上の信頼度スコアを持つ検出を表示・計数する。補正無・補正有に共通である
CLAHE クリップ限界0–8局所的なコントラスト強調の強さ。0 は不適用
ガンマ γ0.3–1.51 未満で暗部を明るくする。1 は不適用
平滑化オン / オフ補正の前に、輪郭を保ったままノイズを抑えるバイラテラルフィルタを適用する

τ の変更は保存済みの検出結果へ即時に反映される。手動の補正は、表示するフレームごとにその場で再推論されるだけであり、動画全体は再解析されない。このため、結果一覧の集計と推移グラフの曲線は解析時の結果のまま変わらない。自動探索の結果では補正無と補正有で τ が異なることがあるため、同じ τ で検出数を比べるには「自動探索の結果を使う」をオフにする。

フレームの移動:スライダ、「◀ 前」「次 ▶」ボタン、← → キー、画像上のマウスホイールで移動する。離れたフレームへ移動した場合、移動先の画素が解析時と一致することを確認できなければ動画を先頭から復号し直すため、表示までに時間を要することがある。

算出過程・AI内部タブ

デモ動画カタログタブ

結果一覧・出力タブ

「成果物を出力」で Darwin Core 形式の CSV、analysis.json、コンタクトシートを outputs フォルダへ書き出す。一覧の検出数は、解析時に自動で選ばれた検出閾値 τ 以上の検出の合計である。「期待語彙一致率」(デモ動画のみ)は、補正有の条件で、検出のクラス名がデモ動画の分類群と同一または上位の分類群を表す語である割合であり、正解率ではない。

キー操作

キー動作
F11全画面表示(4K 等の大画面向け、文字 12 pt)
EscノートPC用サイズ(縦 768 画素の画面向け、文字 9 pt)。プログラムは終了しない
Ctrl+1~5タブの切替
← →解析フレームを前後へ移動(メインタブと算出過程・AI内部タブで有効)
Space表示が「補正無のみ」または「補正有のみ」のとき、両者を交替する。「並列比較」では動作しない

入力欄・表・ボタン・スライダなどにフォーカスがあるときは、← → と Space はその部品の操作に使われる。

使用技術

YOLOE-26(プロンプトフリー重み)

Ultralytics 社が公開する、開放語彙(学習時に定めた少数のクラスに限らず、多数の語で物体を名指しできる)の物体検出・インスタンス分割モデルである。YOLOE(Wang ら, ICCV 2025)の検出器を Ultralytics YOLO26 に置き換えたもので、畳み込みニューラルネットワークが入力画像の 1/8・1/16・1/32 の解像度の特徴マップ(P3 / P4 / P5)を生成し、検出ヘッドが各位置の矩形・領域埋め込み(特徴ベクトル)・マスク係数を出力する。プロンプトフリー重みは、LRPC(Lazy Region-Prompt Contrast)によって領域の特徴を内蔵語彙 4,585 語と照合するため、プロンプト入力もテキスト符号化器も必要としない。

重みは 5 規模(n 16 MB〜x 193 MB)があり、公式配布元から初回使用時に自動取得され、SHA-256 が一致したものだけが使用される。Ultralytics の公表値(LVIS minival)では、プロンプトフリー重みの mAP50-95 は規模 n–x で約 17–31 であり、可視光の一般画像に対しても検出漏れ・誤検出は少なくない。後継の YOLO27 および YOLOE-27 は 2026 年に発表されたが、2026 年 11 月 13 日時点で重みは公開されていない(出典)。

古典的画像処理による夜間画像補正

CIELAB 色空間の明度チャネル L だけに、次の処理を順に施す。色度チャネル a*・b* は変更しないが、明度を大きく変えた画素では、色域外の値が飽和するため色がわずかに変わることがある。

  1. バイラテラルフィルタ(Tomasi・Manduchi, ICCV 1998):輪郭を保ったままノイズを平滑化する(任意)。
  2. 百分位コントラスト伸長:L の 1–99 パーセンタイルを 0–255 へ線形に写像する。
  3. CLAHE(コントラスト制限付き適応的ヒストグラム平坦化。Pizer ら, 1987; Zuiderveld, 1994):画像を 8×8 の区画に分け、局所的にコントラストを強める。
  4. ガンマ変換:L' = 255·(L/255)^γ。γ < 1 で暗部を明るくする。

学習型の低照度画像強調(Zero-DCE、Retinexformer 等)は、画質指標の向上が検出性能の向上と相関しないことが報告されており(Wu ら, 2024, arXiv:2409.14461)、追加の学習済み重みも要する。このため本プログラムは、処理内容を追跡できる古典的手法を採用している。

正解ラベルを用いない代理指標 Q

補正パラメータと検出閾値 τ の自動選択に用いる、本プログラム独自の指標(0–1)である。Q = D × (C + S + T) / 3 であり、τ は検出を数える信頼度スコアの閾値である。D は自動探索に用いる 12 枚のフレームのうち τ 以上の検出があるものの割合、C は τ 以上の検出の平均信頼度スコア、S は矩形の面積と重なりが妥当な検出の割合(空間的整合性)、T は約 0.2 秒離れたフレーム間で検出が対応する度合い(時間的一貫性)を表す。Q は検出の整合性の目安であり、検出精度ではない。

実行上の注意点

実行環境

通信と保存先

処理時間

カメラ

結果の解釈

エラー発生時

通信の切断など想定外の例外が起きた場合は処理が中断され、詳細はコンソール(コンソールのない exe ではプログラムと同じフォルダの console_log.txt)へ出力される。検証済みの結果は保持されるため、原因を取り除いて再実行すれば続きから処理される。

ライセンス(法的助言ではない。最終判断は各ライセンスの原文で確認する)

対象ライセンス利用時の条件
デモ動画CC BY 2.0–4.0作者名・ライセンス名・出典 URL・改変の有無を表示する
デモ動画CC BY-SA 2.0–4.0上記の表示に加え、改変物(補正画像、検出結果を重ねた図、コンタクトシート等)を公開する場合は同一または互換のライセンスで提供する
デモ動画パブリックドメイン著作権上の制約はない。学術上は出典を明記する
YOLOE-26(コードと重み)AGPL-3.0 または Ultralytics Enterprise License本プログラムやその改変版を第三者へ配布、またはネットワーク越しに提供する場合は、全ソースコードを AGPL-3.0 で公開する。公開しない商用利用には Enterprise License が必要である

exeファイルの作成手順


cd /d c:\users\user\proj\wildlife_dataset
python -m venv venv
venv\Scripts\activate.bat
python -m pip install --upgrade pip
pip install -U --no-user pyinstaller pytest ultralytics torch torchvision opencv-python pillow numpy matplotlib
pyinstaller --onefile --clean --noconfirm  --collect-all ultralytics --collect-all torch --collect-all torchvision --collect-all cv2 --collect-all PIL --collect-all numpy --collect-all matplotlib wildlife_dataset.py

実行ファイル:[exe]

実行ファイル(exe)は、Chrome または Firefox を用いてダウンロードすることを推奨。初回実行時に、SmartScreenの「WindowsによってPCが保護されました」の警告画面が出ます。警告画面で「詳細情報」をクリック、「実行」をクリックで続行できます。

ソースコード実行のための前準備

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' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

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)を選択する.

必要なライブラリをシステム領域にインストール

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

以下を実行する。

REM インストール
pip uninstall -y opencv-python-headless opencv-contrib-python-headless opencv-python
pip install --no-user -U numpy torch torchvision --index-url https://download.pytorch.org/whl/%CUDA_TAG%
pip install -U --no-user ultralytics opencv-python pillow matplotlib numpy

ソースコード

保存し、Visual Studio Code などで実行する。