라즈베리파이 11 bullseye에서 OpenCV-Python 설치 및 문제 해결 가이드

라즈베리파이에서 OpenCV-Python 설치 및 문제 해결 가이드

이번 설치는 Mac OS 카탈리나 10.15.3에서 패러렐데스크탑 15.1.2(47123) 버전을 이용해서 라즈베리파이 버전 11 bullseye를 가상으로 인스톨하고 진행했습니다.

 

라즈베리파이에 opencv 까는 게 이렇게 힘든 일은 줄은 생각도 못했습니다. 블로그 여기 저기를 검색하면서 따라해봐도 결과는 마찬가지. 잘 깔리지가 않더군요. 알면 아무 것도 아닌 것이 모르니까 먼 길을 헤매다가 드디어 길을 찾은 기분이 듭니다. 

 

라즈베리파이에서 OpenCV-Python 패키지를 설치하는 과정에서 종종 "패키지를 찾을 수 없습니다"라거나 깔리지 않고 알 수 없는 오류가 발생할 수 있습니다. 이 블로그에서는 이러한 문제를 해결하기 위한 단계별 가이드를 제공합니다.

다음과 같이 apt 옵션을 사용해서 opencv를 인스톨하는 방법이 여러 블로그에 나와 있습니다. 이 방법이 가장 간편한 방법인데 정작 라즈베리파이에서 종종 문제가 발생한다.

sudo apt install opencv-python

패키지 목록을 읽는 중입니다... 완료
의존성 트리를 만드는 중입니다... 완료
상태 정보를 읽는 중입니다... 완료        

opencv-python 패키지를 찾을 수 없습니다

 

라즈베리파이에서 apt를 사용하여 OpenCV를 설치하려면, 기본 저장소에서 제공하는 패키지를 설치해야 합니다. opencv-python 패키지는 기본 저장소에서 제공되지 않기 때문에, 일반적으로 apt를 사용하여 OpenCV를 설치할 때는 python3-opencv 패키지를 사용합니다.

 

 

1. 시스템 패키지 목록 업데이트

먼저 시스템 패키지 목록을 업데이트합니다. 이 단계는 최신 패키지 목록을 받아오기 위해 필요합니다.

sudo apt-get update

 

 

 

2. OpenCV 설치

python3-opencv 패키지를 설치합니다. 이 패키지는 Python 3에서 사용할 수 있는 OpenCV 라이브러리를 포함하고 있습니다.

sudo apt-get install python3-opencv

이 명령어는 OpenCV와 관련된 모든 의존성을 자동으로 설치합니다.

 

 

 

3. 설치된 패키지 확인

설치된 패키지를 확인하여 python3-opencv가 제대로 설치되었는지 확인합니다.

dpkg -l | grep python3-opencv

또는 opencv 모듈을 가져와서 설치가 제대로 되었는지 확인할 수 있습니다.

터미널에서 python을 입력합니다.

import cv2 --->>> opencv를 임포트하는 명령어

 

print(cv2.__version) --->>> 인스톨한 opencv 버전 확인

다음과 같이 터미널에 opencv 버전이 나옵니다. 4.5.1 버전이 인스톨되었습니다. (역시 pip로 인스톨한 것보다 버전이 낮습니다)

파이썬에서 빠져나올 때는 exit() 명령어를 입력합니다. 또는 CTRL + D를 누르면 빠져나옵니다.

 

 

 

 

라즈베리파이에서 인스톨한 앱을 지우는 방법은?

라즈베리파이에서 설치한 앱을 제거하는 방법은 설치 방식에 따라 다릅니다. 초보자가 앱을 깔다보면 많은 실수를 하기 때문에 자신이 인스톨한 앱을 지울 줄도 알아야 합니다.

1. apt로 설치한 경우: apt 패키지 매니저를 사용하여 제거할 수 있습니다.

 

sudo apt remove 패키지명

예를 들어 opencv를 제거하려면:

 

sudo apt remove python3-opencv

y를 입력하고 엔터를 칩니다.

 

 

1. pip로 설치한 경우: pip 명령어로 제거할 수 있습니다.

 

pip uninstall 패키지명

예를 들어 opencv-python을 제거하려면:

 

pip uninstall opencv-python

1. 소스코드에서 직접 빌드한 경우: 보통 make uninstall 명령어를 실행하여 제거할 수 있습니다.

 

sudo make uninstall

1. 데스크톱 앱의 경우: 메뉴 > 환경설정 > 앱 관리에서 앱을 찾아 제거할 수 있습니다.

제거 후에는 종속성 문제로 불필요한 패키지가 남아있을 수 있으므로 다음 명령어로 정리하는 것이 좋습니다.

 

sudo apt autoremove

이렇게 하면 라즈베리파이에 설치된 앱/패키지를 깔끔하게 제거할 수 있습니다.

 

 

 

 

라즈베리파이에 OpenCV를 인스톨하는 방법 두 가지!

apt를 이용하는 갓과 pip 옵션을 이용하는 방식이 있다.  많은 블로그에서 이 두 가지 방식으로 인스톨하는 법을 마구 섞어놓아서 초보자에게는 너무 헤깔린 부분이 많습니다. 도대체 왜 두 가지 방식으로 인스톨을 해야 하는 건지. 초보자에게는 한없이 어렵습니다.

 

그럼 이 두 가지 방식의 차이에 대해서 알아보겠습니다.

 

라즈베리파이에서 opencv를 인스톨할 때, apt로 까는 것과 pip로 까는 것의 차이는 무엇일까요?

 

라즈베리파이에서 OpenCV를 설치할 때 apt와 pip의 주요 차이점은 다음과 같습니다:

1. 설치 패키지 형식
   • apt: 데비안 기반 리눅스 배포판용 패키지 관리 시스템으로, .deb 패키지를 설치합니다.
   • pip: Python 패키지 관리 시스템으로, Python 패키지를 설치합니다.
2. 설치 버전
   • apt: 레포지토리에 있는 OpenCV 버전을 설치합니다. 일반적으로 안정적이지만 최신 버전이 아닐 수 있습니다.
   • pip: PyPI(Python Package Index)에 있는 최신 OpenCV 버전을 설치합니다.
3. 의존성 처리
   • apt: 설치 시 자동으로 필요한 의존성 패키지를 함께 설치합니다.
   • pip: 의존성 패키지를 직접 설치해야 하는 경우가 있습니다.
4. 통합성
   • apt로 설치한 OpenCV는 시스템 레벨에서 통합되어 다른 애플리케이션에서도 사용할 수 있습니다.
   • pip로 설치한 OpenCV는 가상 환경 내에서만 사용할 수 있습니다.

일반적으로 라즈베리파이에서 OpenCV를 사용하려면 apt로 설치하는 것이 더 간편합니다. 하지만 최신 버전이 필요하거나 Python 가상 환경을 사용하는 경우에는 pip를 사용해야 합니다.

레포지토리(Repository)는 소프트웨어 개발에서 코드를 저장하고 관리하는 곳을 말합니다. 레포지토리는 소스 코드, 라이브러리, 문서, 설정 파일 등을 조직적으로 보관하며, 버전 관리 시스템과 함께 사용되어 프로젝트의 모든 변경 사항을 추적하고 관리할 수 있습니다.

 

 

PIP로 opencv 인스톨하는 방법

 

1. Python 환경 확인

라즈베리파이에서 Python 3이 설치되어 있는지 확인합니다.

터미널에서 입력합니다.

python3 --version

 

 

2. pip 업데이트

pip가 최신 버전인지 확인하고 업데이트합니다.

sudo apt-get update
sudo apt-get install python3-pip
pip3 install --upgrade pip

 

 

3. opencv-python 패키지 설치

opencv-python 패키지를 설치합니다.

pip3 install opencv-python

 

 

4. 의존성 패키지 설치

필요한 의존성 패키지들을 설치합니다.

sudo apt-get install libhdf5-dev libhdf5-serial-dev libhdf5-103
sudo apt-get install libqtgui4 libqtwebkit4 libqt4-test python3-pyqt5
sudo apt-get install libatlas-base-dev

 

 

5. 가상 환경 사용 (선택 사항)

가상 환경을 사용하여 Python 패키지를 격리하여 설치할 수 있습니다.

sudo apt-get install python3-venv
python3 -m venv myenv
source myenv/bin/activate
pip install opencv-python

 

 

6. 설치된 패키지 확인

설치된 패키지를 확인하여 opencv-python이 제대로 설치되었는지 확인합니다. 버전 4.9.0.80이 인스톨 되었습니다. 위에 apt로 인스톨한 것보다 버전이 높은 것을 알 수 있습니다.

pip3 list | grep opencv-python

 

 

7. 샘플 코드 테스트

패키지가 제대로 설치되었는지 확인하기 위해 간단한 OpenCV 코드를 실행해봅니다. 터미널에서 python을 입력합니다.

python
import cv2
print(cv2.__version__)

OpenCV 버전 확인

이 코드를 test_opencv.py 파일로 저장하고 실행합니다.

python3 test_opencv.py

 

이 단계를 따르면 라즈베리파이에서 opencv-python 패키지를 성공적으로 설치하고 사용할 수 있습니다. 문제가 지속된다면, 구체적인 오류 메시지를 제공하여 추가적인 도움을 받을 수 있습니다.

이 가이드가 라즈베리파이에서 OpenCV-Python 패키지를 설치하는 데 도움이 되길 바랍니다. 성공적으로 설치되었다면, 다양한 OpenCV 프로젝트를 시작해보세요!