Cara menggunakan opencv-python download

Halo netizen,

Sejujurnya saya sedang bahagia karena telah menemukan solusi dari masalah yang sudah satu semester ini saya temui. Apa itu? Menginstall OpenCV dan menjalankannya di IDE selain Spyder!

Jadi awal cerita, pada satu mata kuliah pemrosesan citra, saya diminta untuk menginstall OpenCV. Karena saya menginstall Python melalui Anaconda, maka saya melakukan installasi melalui Anaconda pula. Masalah awal muncul ketika saya hanya bisa menjalankannya pada IDE Spyder (sebuah IDE bundling dengan Anaconda). Karena tampilan Spyder yang tidak menarik juga karena tidak ada fitur code assistance / completion. Maklum, saya masih amatir dan lebih cepat jika menggunakan mode tersebut. Setelah ‘utek-utek’ masalah tersebut, mencari dimana-mana, akhirnya saya menyerah dan berakhir dengan IDE Spyder.

Hikmah muncul ketika laptop saya harus install ulang windows dan saya bertekad untuk menyelesaikan masalah yang sudah lama itu (selagi liburan). Jadi saya menginstall lagi Python 3 (tutorial install Python ada di medium saya) beserta segala library pendukung lainnya. Dari pada kebanyakan cakap, mari kita langsung saja dengan tutorialnya!

1. Buka CMD dalam mode administrator. Caranya, cari cmd di Windows Start kemudian klik kanan pada Command Promt dan pilih Run as administrator.

2. Pastikan Anda sudah menginstall python. Apabila belum, bisa cek medium saya untuk menginstall Python 3 di Windows Anda. Cara cek apakah python sudah terinstall adalah dengan cara ketik ini di cmd Anda.

python

Apabila berhasil, maka tidak akan ada error yang muncul. Untuk kembali, ketikkan

exit()

3. Pastikan juga Anda telah menginstall dan update PIP.

4. Sebelum install opencv, ada baiknya menginstall numpy sebagai prasyarat, caranya ketikkan ini pada cmd

pip install numpy

*cara lain adalah setelah menginstall IDE Pycharm, buka File > Settings > Project Interpreter > Cari tanda panah warna hijau (hint bertuliskan install), kemudian cari numpy dan klik install package

5. Karena setelah mencoba menginstall opencv melalui pip dan saya tidak berhasil, maka dengan cara kali ini adalah dengan download package melalui http://www.lfd.uci.edu/~gohlke/pythonlibs/ dan cari di bagian OpenCV dengan versi yang sesuai dengan python yang sudah diinstall. Karena saya menginstall python 3.7, maka saya memilih opencv_python‑3.4.2+contrib‑cp37‑cp37m‑win_amd64.whl.

6. Setelah berhasil mendownload file whl, buka cmd ke dalam folder tempat file whl tersebut dan ketik di cmd pip install “nama_file.whl”. Untuk kasus saya, saya mengetikkan pip install “opencv_python‑3.4.2+contrib‑cp37‑cp37m‑win_amd64.whl”

7. Terakhir, pada kasus di pc saya, saya harus mengubah nama file pyd di dalam folder Python. Caranya adalah masuk ke dalam folder python (biasanya di C://PythonXX atau C://Program Files/PythonXX), kemudian masuk ke dalam file Lib\site-packages, disana akan ditemui file berawalan cv2 dengan ekstensi .pyd. Ganti nama file tersebut menjadi cv2.pyd. Terakhir, copy file tersebut dan paste ke dalam folder DLLs (di dalam folder Python).

8. Selesai! Selamat, anda sudah berhasil menginstall opencv. Untuk cek, ketik di cmd python, kemudian ketik import cv2. Apabila tidak ada pesan error, berarti anda sudah berhasil!

Sekian tutorial dari saya, apabila ada pertanyaan seputar installasi opencv di python 3, jangan sungkan untuk bertanya.

Salam, D.

Pada turorial ini kita belajar bagaimana cara install OpenCV 4 pada Operating System Ubuntu, ini merupakan langkah pertama yang harus kita lewati untuk dapat mempelajari Computer Vision, Deep Learning, dan OpenCV.

Sebelum masuk ke langkah-langkah instalasi, temen-teman harus memperhatikan poin berikut ini:

  1. Pada saat artikel ini dibuat saya menggunakan OS Ubuntu 20.04.
    Cara menggunakan opencv-python download
  2. dan versi Python yang saya gunakan yaitu versi Python 3.8.10.
    Cara menggunakan opencv-python download
  3. Oke tanpa panjang lebar yok kita mulai langkah-langkahnya.

Langkah 1: Install Dependencies OpenCV 4 pada Ubuntu

Pertama update sistem terlebih dahulu:

sudo apt-get update

sudo apt-get upgrade

Kemudian install developer tools:

sudo apt-get install build-essential cmake unzip pkg-config

Selanjutnya install beberapa libraries I/O image dan video.

sudo apt-get install libjpeg-dev libpng-dev libtiff-dev

sudo apt-get install libavcodec-dev libavformat-dev libswscale-dev libv4l-dev

sudo apt-get install libxvidcore-dev libx264-dev

Libraries ini memungkinkan kita untuk menampilkan image dan video dari storage komputer atau laptop, lalu install GTK untuk backend GUI:

sudo apt-get install libgtk-3-dev

lalu diikuti dengan menginstall 2 packages yang berisi optimasi matematika untuk OpenCV yang akan kita install:

sudo apt-get install libatlas-base-dev gfortran

dan yang terakhir mari kita install header development Python 3:

sudo apt-get install python3-dev

Setelah menginstal semua persyaratan di atas, maka kita dapat melanjutkan ke langkah berikutnya.

Langkah 2: Download OpenCV 4

Langkah berikutnya kita akan menginstal OpenCV dengan menavigasikan terminal kita ke folder home dan download opencv dan opencv_contrib. Repository dari contrib di dalamnya memiliki extra module dan functions yang akan sering kita gunakan selama mempelajari Computer Vision, Deep Learning, and OpenCV. Jadi… jangan sampai ada langka-langkah yang terlewat ya guys!

Oke langsung saja, download opencv dan opencv_contribut:

cd~

wget-Oopencv.zip https://github.com/opencv/opencv/archive/4.5.4.zip

wget-Oopencv_contrib.zip https://github.com/opencv/opencv_contrib/archive/4.5.4.zip

dan kita unzip dengan command berikut:

unzip opencv.zip

unzip opencv_contrib.zip

kemudian rename direktorinya:

mv opencv-4.5.4opencv

mv opencv_contrib-4.5.4opencv_contrib

namun jika temen-temen tidak melakukan rename, jangan lupa update path dari CMake (akan dijelaskan pada langkah selanjutnya).

Sekarang opencv dan opencv_contrib sudah ter-download dan siap digunakan, selanjutnya kita akan set up environtment yang dibutuhkan.

Langkah 3: Konfigurasi Virtual Environment untuk Python 3 dan OpenCV 4

Selanjutnya kita install pip (Python Package Manager) dengan command berikut:

wget https://bootstrap.pypa.io/get-pip.py

sudo python3 get-pip.py

Memanfaatkan Virtual Environtments untuk Python Development

Virtual Environmens untuk Python memungkinkan kita melakukan isolasi pada saat mengerjakan project Python dan merupakan cara yang terbaik untuk Python Development. 

Sebagai contohnya ketika kita memiliki sebuah project Python + OpenCV yang membutuhkan scikit-learn (v0.14) versi lama, namun kita ingin tetap menggunakan scikit-learn versi terbaru untuk project kita yang lain. Maka dengan menggunakan Virtual Environment kita dapat menangani kedua dependencies yang berbeda versi tersebut secara terpisah.

Informasi lebih lanjut mengenai Virtual Environment dapat temen-temen lihat pada artikel ini Real Python atau di sini PyImageSearch.

Catatan: Untuk menjalankan project Python dengan Virtual Environment saya menggunakan package virtualenv dan virtualenvwrapper, namun teman-temen dapat melewati bagian ini jika lebih femiliar dengan conda atau PyEnv.

Oke selanjutnya kita create dan manage Python Virtual Environment dengan menginstal virtualenv dan virtualenvwrapper:

sudo pip install virtualenv virtualenvwrapper

sudo rm-rf~/get-pip.py~/.cache/pip

untuk menyelesaikan instalasi ini, kita perlu melakukan update pada file ~/.bashrc menggunakan terminal seperti vi vim atau nano:

dan tambahkan code berikut pada baris paling akhir:

# virtualenv and virtualenvwrapper

export WORKON_HOME=$HOME/.virtualenvs

export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3

source /usr/local/bin/virtualenvwrapper.sh

kemudian kita baca dan eksekusi perintah dari file ~/.bashrc dengan menggunakan command:

Membuat Virtual Environment untuk menampung OpenCV 4 dan paket tambahan pendukungnya

Langkah pertama yang harus dilakukan pada bagian ini yaitu:

mkvirtualenv cv-ppython3

command ini berfungsi untuk membuat Virtual Environment Python 3 yang bernama cv (pemberian nama disini sebenarnya tergantung keinginan teman-teman, yang penting singkat dan cukup memberikan informasi tentang fungsi penamaan tersebut). Contoh penamaan lain seperti:

  • py3cv4 (Penjelasan: Python 3 + OpenCV 4)
  • py3cv3 (Python 3 + OpenCV 3)
  • py2cv2 (Python 2 + OpenCV 2)
  • dan lain sebagainya.

Sehingga berdasarkan penjelasannya, penamaan Virtual Environment tersebut mudah diingat dan mudah dipahami serta memungkinkan kita beralih versi Python dan OpenCV dengan mudah juga tidak membingungkan.

Mari kita lakukan verifikasi bahwa saat ini kita berada di Environment cv dengan menggunakan command workon:

Install NumPy

Package pertama dan satu-satunya persyaratan Python yang kita butuhkan yaitu NumPy:

Sampai sini kita dapat menyiapkan OpenCV 4 untuk dikompilasi pada mesin Ubuntu yang kita miliki.

Langkah 4: CMake dan kompilasi OpenCV 4 untuk Ubuntu

Pada langkah ini kita akan menyiapkan kompilasi dengan CMake diikuti dengan menjalankan command make untuk mengkompilasi OpenCV. Arahkan kembali terminal ke repositori OpenCV dan create + masuk ke folder build:

cd~/opencv

mkdir build

cd build

Jalankan CMake untuk OpenCV 4

Sekarang ayo kita jalankan CMake untuk mengkonfigurasi OpenCV 4:

cmake-DCMAKE_BUILD_TYPE=RELEASE\

-DCMAKE_INSTALL_PREFIX=/usr/local\

-D INSTALL_PYTHON_EXAMPLES=ON\

-DINSTALL_C_EXAMPLES=OFF\

-DOPENCV_ENABLE_NONFREE=ON\

-D OPENCV_EXTRA_MODULES_PATH=~/opencv_contrib/modules\

-DPYTHON_EXECUTABLE=~/.virtualenvs/cv/bin/python\

-DBUILD_EXAMPLES=ON..

Pada command di atas, teman-teman harus memastikan script struktur direktori pada OPENCV_EXTRA_MODULES_PATH dan PYTHON_EXECUTABLE sesuai dengan struktur direktori pada laptop atau komputer yang teman-teman miliki. Namun jika strukturnya sama maka script struktur direktori pada OPENCV_EXTRA_MODULES_PATH dan PYTHON_EXECUTABLE tidak perlu ada yang diperbaharui.

Setelah CMake selesai dieksekusi, teman-teman harus pastikan outputnya kurang lebih sama seperti yang saya miliki di bawah ini:

Cara menggunakan opencv-python download

Perhatikan gambar di atas dan teman-teman luangkan waktu sejenak untuk memastikan Interpreter menunjuk ke binary Pyton 3. Kemudian pastikan juga bahwa numpy telah terinstal di dalam Virtual Environment (.virtualenvs).

Cara menggunakan opencv-python download

Lalu yang terakhir pastikan Non-free algorithms juga berhasil terinstal dengan flag YES.

Melakukan Compile OpenCV 4

Sekarang saatnya kita melakukan compile OpenCV 4 dengan command berikut ini:

Catatan: Pada command make di atas, terdapat argumen -j8 yang berfungsi menetapkan core CPU untuk kompilasi OpenCV 4 pada laptop saya. Pada umumnya laptop atau komputer memiliki core CPU yang bermacam-macam seperti 2, 4, 8, atau bahkan 16 core. Sehingga teman-teman harus memperbaharui command di atas dengan menyesuaikan jumlah core CPU laptop atau komputer yang teman-teman miliki. Jika terjadi kegagalan pada saat kompilasi, teman-teman dapat mencoba ulang kompilasi dengan 1 core CPU saja.

Berikut hasil kompilasi OpenCV 4 tanpa adanya error:

Cara menggunakan opencv-python download

kemudian kita install OpenCV 4 dengan 2 command tambahan berikut:

sudo make install

sudo ldconfig

Langkah 5: Menghubungkan OpenCV 4 ke dalam Virtual Environment Pyhton 3 yang sudah kita buat

Sebelum kita menghubungkan OpenCV 4 ke dalam Virtual Environment Python 3, mari kita lihat versi Python yang kita miliki:

workon cv

python--version

Cara menggunakan opencv-python download

Dengan mengetahui versi Python, kita dapat dengan mudah memilih direktori site-packages Python yang benar. Berikut path direktori yang saya miliki:

Cara menggunakan opencv-python download

kemudian akses path direktori melalui terminal seperti berikut:

Cara menggunakan opencv-python download

dan rename file cv2.cpython-38-x86_64-linux-gnu.so menjadi cv2 dengan menggunakan command berikut:

cd/usr/local/lib/python3.8/dist-packages/cv2/python-3.8

sudo mv cv2.cpython-38-x86_64-linux-gnu.so cv2.so

Catatan: Jika teman-teman memiliki OpenCV 3 dan OpenCV 4 secara bersama-sama, file cv2.cpython-38-x86_64-linux-gnu.so dapat teman-teman rename menjadi cv2.opencv4.0.0.so. Namun jika teman-teman tetap menggunakan cv2.so maka itu tidak menjadi masalah.

sub-step yang terakhir yaitu menghubungkan OpenCV cv2.so ke virtual environment cv yang kita miliki:

cd~/.virtualenvs/cv/lib/python3.8/site-packages/

ln-s /usr/local/lib/python3.8/dist-packages/cv2/python-3.8/cv2.so cv2.so

maka cv2.so akan ada pada direktori ~/.virtualenvs/cv/lib/python3.8/site-packages/

Cara menggunakan opencv-python download

Langkah 6: Menguji instalasi OpenCV 4 pada Ubuntu

Mari kita lakukan tes cepat untuk melihat apakah OpenCV siap digunakan atau belum, dengan cara buka terminal dan lakukan hal berikut:

workon cv

python

>>>import cv2

>>>cv2.__version__

>>>quit()

command pertama berfungsi untuk mengaktifkan virtual environment, lalu kita jalankan interpreter Python yang terhubung pada virtual environment yang kita miliki.

Catatan: Pada command ke 2 kita tidak perlu menentukan Python2 atau Python3 karena Python 3 akan secara otomatis dieksekusi pada virtual environment.

Kemudian pada saat kita mengeksekusi cv2.__version__ dan versi cv muncul, maka artinya kita sudah berhasil melakukan instalasi OpenCV pada laptop atau komputer kita.


Jika ada pertanyaan silahkan komen dan jika artikel ini dirasa bermanfaat, jangan lupa like dan sharenya ya teman-teman. 😀 Sampai bertemu di artikel selanjutnya.
Terima Kasih, Assalamu’alaykum… Salam KODINGINDONESIA

Referensi:

  1. https://www.pyimagesearch.com/
  2. https://opencv.org/