OpenCV-PythonをWindowsにインストール

目的

このチュートリアルでは
  • Windows上にOpenCV-Pythonをインストールする方法を学びます．

以下のインストール方法はWindows 7(64ビット)とVisual Studio 2010とVisual Studio 2012で動作確認をしました．スクリーンショット画面はVisual Studio 2012のものです．

プレビルトバイナリファイルからOpenCVをインストール

  1. 以下のPythonのパッケージをダウンロードし，デフォルトのフォルダにインストールします．

    1.1. Python-2.7.x.

    1.2. Numpy.

    1.3. Matplotlib (Matplotlib is optional, but recommended since we use it a lot in our tutorials).

  2. 全てのパッケージをデフォルトのフォルダにインストールしてください．Pythonは C:/Python27/ にインストールされます．

  3. インストールが終了したらPythonのターミナルを開きます．ターミナル上で import numpy と実行してNumpyが正しく動作することを確認してください．

  4. 最新版のOpenCVを sourceforge site からダウンロードして解凍してください．

  1. opencv/build/python/2.7 フォルダに移動してください．

  2. フォルダ内の cv2.pyd を C:/Python27/lib/site-packeges フォルダ内にコピーしてください．

  3. 改めてPythonターミナルを開き，以下のコードを実行してください．

    >>> import cv2
>>> print cv2.__version__

エラーメッセージが無く結果が表示されればOpenCV-Pythonのインストールに成功したことになります!!!

OpenCVをソースからビルド

  1. Visual StudioとCMあけをインストールしてください．

  2. 以下の必要なPythonパッケージをダウンロードし，デフォルトフォルダにインストールしてください．

    2.1. Python 2.7.x

    2.2. Numpy

    2.3. Matplotlib (Matplotlib is optional, but recommended since we use it a lot in our tutorials.)

Note

この説明では32bit版のPythonパッケージを使っています．64bit版のOpenCVを使いたいのであればPythonパッケージも64bit版のものをインストールしてください．問題はNumpyが公式に64bitマシンをサポートしていないため，Numpyを自分でビルドしなければいけない点です．そのためにはPythonのビルドに使うコンパイラと同じコンパイラを使わなければいけません．Pythonターミナルを開くとコンパイラの詳細が表示されます． ここ に詳しい説明が書いてあります．Numpyをビルドする時に使うものと同じVisual Studioをインストールしてある必要があります．

Note

64bit版のPythonパッケージをインストールするもう一つの方法は Anaconda, や Enthought のような第三者によって提供されているパッケージを使う方法です．インストールされるファイルのサイズは大きくなりますが，必要とされるものを全てインストールできます．このようなサードパーティのパッケージ群は32bit版も同様にインストール可能です．

  1. PythonとNumpyが正しく動作する事を確認してください．．

  2. OpenCVのソースコードをダウンロードしてください． Sourceforge から公式リリース版のソースコードをダウンロードできます．もしくは`Github <https://github.com/Itseez/opencv>`_ からソースコードをダウンロードできます．

  3. opencv というフォルダ内に解凍し， build という名前のフォルダを作成してください．

  4. CMake-GUIを開いてください (スタート > 全てのプログラム > CMake-gui)

  5. 以下の画像に示しているようにフィールドに値を入れてください:

    7.1. Browse Source… ボタンをクリックし，先ほどの opencv フォルダを指定してください．

    7.2. Browse Build… ボタンをクリックし，先ほど作成した build フォルダを指定してください．

    7.3. Configure ボタンをクリックしてください．

    capture1

    7.4. コンパイラ選択するためのウィンドウが表示されるので，正しいコンパイラを選択して(ここではVisual Studio 11を選択します) Finish ボタンをクリックしてください．

    capture2

    7.5. 解析が終わるまで待ってください．

  6. 解析が終了すると全フィールドが赤くマークされます． WITH フィールドをクリックし，サブフィールドを展開させ，以下の図を参考に必要なフィールドをマークしてください:

    capture3

  7. 必要なフィールドのマークが終わったら BUILD フィールドをクリックして展開してください．最初の幾つかのフィールドがビルド方法の構成です．以下の画像を参考にしてください:

    capture5

  8. 以降のフィールドはビルドするモジュールを指定するためのものです．現時点(OpenCV3.0.0の時点?)でOpenCV-PythonはGPU関連のモジュールはサポートしていないので，時間節約のためこれらのモジュールのビルドをする必要はありません(必要であればビルドしてください)．以下の画像を参考にしてください:

    capture6

  9. 次に， ENABLE フィールドをクリックして展開し， ENABLE_SOLUTION_FOLDERS のチェックが外れていることを確認してください(ソリューションフォルダはVisual Studio Express版ではサポートされていません)．以下の画像を参考にしてください:

    capture7

  10. また， PYTHON フィールドの全てがチェックされているか確認してください(ただし， PYTHON_DEBUG_LIBRARY は無視してください)．以下の画像を参考にしてください:

    capture80

  11. 最後に Generate ボタンを押してください．

  12. それでは opencv/build フォルダを見てください． OpenCV.sln ファイルができているはずです．早速Visual Studioで開いてください．

  13. ビルドモードを Debug ではなく Release に変更してください．

  14. ソリューションエクスプローラー内の Solution (もしくは ALL_BUILD) を右クリックし，ビルドしてください．終了までにある程度時間がかかります．

  15. 次に INSTALL を右クリックしビルドするとOpenCV-Pythonがインストールされます．

    capture8

  16. Pythonターミナルを開き， import cv2 と実行してください．何もエラーが表示されなければインストールが正しくできたことを意味します．

Note

この例ではTBB, Eigen, Qtなどのサポート無しでインストールしました．ここで説明をするのは大変なので，さらなる詳細を説明するビデオが追加されるのを待つか，自分の手で色々いじってみてください．

補足資料

課題

  1. Windowsマシンを持っているのであれば，OpenCVをソースからコンパイルしてみてください．その際に，あらゆるカスタマイズを試してみてください．何かエラーなどが起きればOpenCVのフォーラムを訪問し自分の問題を説明してください．