Python 用 opencv-python のインストール(Windows 上)

要約】 opencv-pythonは,コンピュータビジョンライブラリOpenCVのPythonインターフェースである.Windows上でのインストール手順は以下の通り:管理者権限でコマンドプロンプトを実行し,Python 64ビット版がインストールされていることを確認後,pipコマンドを使用してopencv-pythonとopencv-contrib-pythonをインストールする.インストール後,バージョン確認を行い,サンプル画像(fruits.jpg)を用いた画像表示プログラムを実行して動作確認を行う.

OpenCV (Open Computer Vision Library) は, 実時間コンピュータビジョン (real time computer vision) の アルゴリズムと文書とサンプルコードの集まり.

目次

サイト内の関連ページ

前準備

Python 3.12 のインストール

インストール済みの場合は実行不要。

管理者権限でコマンドプロンプトを起動(手順:Windowsキーまたはスタートメニュー > cmd と入力 > 右クリック > 「管理者として実行」)し、以下を実行する。管理者権限は、wingetの--scope machineオプションでシステム全体にソフトウェアをインストールするために必要である。

REM Python をシステム領域にインストール
winget install --scope machine --id Python.Python.3.12 -e --silent
REM Python のパス設定
set "PYTHON_PATH=C:\Program Files\Python312"
set "PYTHON_SCRIPTS_PATH=C:\Program Files\Python312\Scripts"
echo "%PATH%" | find /i "%PYTHON_PATH%" >nul
if errorlevel 1 setx PATH "%PATH%;%PYTHON_PATH%" /M >nul
echo "%PATH%" | find /i "%PYTHON_SCRIPTS_PATH%" >nul
if errorlevel 1 setx PATH "%PATH%;%PYTHON_SCRIPTS_PATH%" /M >nul

関連する外部ページ

Python の公式ページ: https://www.python.org/

AI エディタ Windsurf のインストール

Pythonプログラムの編集・実行には、AI エディタの利用を推奨する。ここでは,Windsurfのインストールを説明する。

管理者権限でコマンドプロンプトを起動(手順:Windowsキーまたはスタートメニュー > cmd と入力 > 右クリック > 「管理者として実行」)し、以下を実行して、Windsurfをシステム全体にインストールする。管理者権限は、wingetの--scope machineオプションでシステム全体にソフトウェアをインストールするために必要となる。

winget install --scope machine Codeium.Windsurf -e --silent

関連する外部ページ

Windsurf の公式ページ: https://windsurf.com/

Python 用 opencv-python のインストール

  1. Windows で,管理者権限コマンドプロンプトを起動(手順:Windowsキーまたはスタートメニュー > cmd と入力 > 右クリック > 「管理者として実行」)。
  2. 使用する Python のバージョンの確認
    python --version
    
  3. 旧バージョンのものを削除,Python 用 opencv-python のインストール
    python -m pip uninstall -y opencv-python
    python -m pip uninstall -y opencv-python-headless
    python -m pip uninstall -y opencv-contrib-python
    python -m pip install -U opencv-python opencv-contrib-python
    
  4. 確認のためバージョン確認

    * バージョン番号が「4.1.2」のように表示されれば OK.下の図とは違うバージョンが表示されることがある

    python -c "import cv2; print( cv2.__version__ )"
    

確認のため Python プログラムを動かしてみる

画像ファイル fruits.jpg のダウンロード

https://github.com/opencv/opencv/tree/master/samples/data で公開されている fruits.jpg を使用している

画像ファイル fruits.jpg のダウンロードは, 次のコマンドを実行する.(Ubuntu での curl のインストールは「sudo apt -y install curl」)

cd /d c:%HOMEPATH%
curl -L https://github.com/opencv/opencv/blob/master/samples/data/fruits.jpg?raw=true -o fruits.jpg

画像表示プログラムの実行

Python プログラムの実行

Python 開発環境(Jupyter Qt Console, Jupyter ノートブック (Jupyter Notebook), Jupyter Lab, Nteract, Spyder, PyCharm, PyScripterなど)も便利である.

Python のまとめ: 別ページにまとめている.

import cv2
bgr = cv2.imread('c:/opencv/sources/samples/data/fruits.jpg')
cv2.imshow("", bgr)
cv2.waitKey(0)
cv2.destroyAllWindows()

画像が表示されるので確認. このあと,ウインドウの右上の「x」をクリックしない.画面の中をクリックしてから,何かのキーを押して閉じる

【まとめ】 Python環境確認後,pipでopencv-pythonをインストール,サンプルプログラムで動作確認.