OpenCV, opencv_contrib，Python の OpenCV ライブラリのインストール（Ubuntu 上）

apt を用いて OpenCV をインストールする． Ubuntu の公式リポジトリ（universe）に収録されている OpenCV のバージョンは， Ubuntu 24.04 では 4.6.0，Ubuntu 26.04 では 4.10.0 である．

【関連する外部ページ】

【サイト内の関連ページ】

OpenCV

OpenCV は，実時間コンピュータビジョン (real time computer vision) のアルゴリズム，文書，サンプルコードの集まりである．

前準備

Ubuntu のシステム更新

Ubuntu で OS のシステム更新を行うときは， 端末で，次のコマンドを実行する。これは、パッケージ情報を最新の状態に保ち、インストール済みのパッケージをセキュリティアップデートやバグ修正を含めて更新するためである。

Ubuntu のインストールはこちらの別ページで説明する。 

# パッケージリストの情報を更新
sudo apt update
# インストール済みのパッケージを包括的に更新 (依存関係も考慮)
sudo apt full-upgrade
# カーネル更新等で実際に再起動が必要な場合のみ実行を推奨
# sudo shutdown -r now

OpenCV のインストール

OpenCV の開発用ファイル，opencv_contrib（追加モジュール），Python 3 用のバインディングをインストールする． 端末で，次のコマンドを実行する． 

# パッケージリストの情報を更新
sudo apt update
sudo apt -y install libopencv-dev libopencv-core-dev python3-opencv libopencv-contrib-dev opencv-data

インストールされたバージョンを確認するときは， 端末で，次のコマンドを実行する． 

pkg-config --modversion opencv4
python3 -c "import cv2; print(cv2.__version__)"

OpenCV を用いた画像表示の例

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

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

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

curl -L -o fruits.jpg https://raw.githubusercontent.com/opencv/opencv/master/samples/data/fruits.jpg

OpenCV で画像表示を行う C++ プログラム

次のプログラムを，ファイル名 a.cpp で保存する．

画像ファイルを準備しておく（ここでは，プログラム内でファイル名を fruits.jpg にしている）． 

#include<opencv2/opencv.hpp>

int main (int argc, char *argv[])
{
  cv::Mat bgr = cv::imread("fruits.jpg");
  cv::imshow("", bgr);
  cv::waitKey(0);
  cv::destroyAllWindows();

  return 0;
}

ビルドと実行は，端末で，次のコマンドを実行する． pkg-config を用いると，OpenCV のヘッダファイルとライブラリの指定が自動で行われる． 

g++ -o a.out a.cpp $(pkg-config --cflags --libs opencv4)
./a.out

画像表示が行われる．画面をクリックし，なにかのキーを押して閉じる．

OpenCV で画像表示を行う Python プログラム

Python3 開発用ファイル，pip, setuptools, venv のインストール（Ubuntu 上）

Python のインストールは行わない（Ubuntu のシステム Python を用いる．） Ubuntu 24.04 のシステム Python は 3.12，Ubuntu 26.04 のシステム Python は 3.14 である．

Python, pip のコマンドでの起動のまとめ．

Ubuntu のシステム Python を用いるとき， python, pip は，次のコマンドで起動できる．

Ubuntu 24.04 以降のシステム Python は 外部管理環境 (externally-managed-environment) であり， pip でシステム全体にパッケージをインストールすることはできない． パッケージを追加するときは，apt のパッケージ（python3-〜）を用いるか， venv による仮想環境を作成してその中で pip を使用する．

Ubuntu での Python 開発環境（JupyterLab, spyder, nteract）のインストール: 別ページ »で説明

Python3 開発用ファイル，pip, setuptools, venv のインストール

端末で，次のコマンドを実行する． 

# パッケージリストの情報を更新
sudo apt update
sudo apt -y install python-is-python3 python3-dev python-dev-is-python3 python3-pip python3-setuptools python3-venv build-essential
venv による仮想環境を作成し，その中で pip を使用するときは， 端末で，次のコマンドを実行する． 仮想環境の中では，apt でインストールした python3-opencv は既定では参照されないため， opencv-python を pip でインストールしている． 
python3 -m venv ~/venv
source ~/venv/bin/activate
pip install -U pip setuptools opencv-python

Python の画像表示プログラム

Python プログラムの実行

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

Python のまとめ: 別ページ »にまとめ

Python プログラムの実行は， 端末で，次のコマンドを実行する． 

python3

Python の対話環境で，次のプログラムを実行する． 

import cv2
bgr = cv2.imread('fruits.jpg')
cv2.imshow("", bgr)
cv2.waitKey(0)
cv2.destroyAllWindows()

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