Linux 환경에서 소스 빌드를 통한 OpenBR 안면 인식 라이브러리 설치 가이드

OpenBR은 안면 인식, 성별 식별, 연령 추정 및 다양한 생체 인식 기능을 제공하는 강력한 오픈소스 프레임워크입니다. Ubuntu 12.04나 Linux Mint 13과 같은 이전 세대의 리눅스 배포판에서는 패키지 관리자가 최신 의존성 라이브러리를 지원하지 않는 경우가 많아, 소스 코드를 직접 컴파일하여 설치하는 과정이 필요합니다.

빌드 전 준비 사항

OpenBR을 성공적으로 빌드하기 위해서는 다음과 같은 특정 버전 이상의 라이브러리가 시스템에 구성되어 있어야 합니다.

CMake 2.8.11 이상: 이전 버전의 Ubuntu는 낮은 버전의 CMake를 제공하므로 직접 빌드가 권장됩니다.
Qt 5.0 이상: OpenBR의 GUI 구성 요소와 핵심 로직에 필요합니다.
OpenCV 2.4.9: OpenBR 0.5 버전은 OpenCV 3.0 버전과 호환성 문제가 발생할 수 있으므로 2.4.9 버전을 사용하는 것이 안전합니다.

1단계: CMake 최신 버전 컴파일

시스템 기본 패키지 관리자의 CMake 버전이 낮다면, 최신 소스를 가져와 설치를 진행합니다.

git clone https://github.com/Kitware/CMake.git
cd CMake
./bootstrap --prefix=/usr/local
make -j$(nproc)
sudo make install
sudo ldconfig

2단계: Qt5 라이브러리 설치

Qt 공식 웹사이트에서 리눅스용 실행 파일을 다운로드하여 설치합니다. 여기서는 5.3.2 버전을 예시로 사용합니다.

wget http://download.qt.io/new_archive/qt/5.3/5.3.2/qt-opensource-linux-x64-5.3.2.run
chmod +x qt-opensource-linux-x64-5.3.2.run
sudo ./qt-opensource-linux-x64-5.3.2.run

설치 마법사가 실행되면 지시에 따라 설치를 완료합니다. 일반적으로 /opt/Qt5.3.2/ 경로에 설치됩니다.

3단계: OpenCV 2.4.9 빌드

OpenBR과의 호환성을 위해 OpenCV 2.4.9 버전을 빌드합니다. 최신 3.x 버전 사용 시 컴파일 에러가 발생할 수 있으므로 주의해야 합니다.

wget https://github.com/opencv/opencv/archive/2.4.9.zip
unzip 2.4.9.zip
cd opencv-2.4.9
mkdir build_dir && cd build_dir

cmake -D CMAKE_BUILD_TYPE=RELEASE \
      -D CMAKE_INSTALL_PREFIX=/usr/local \
      -D WITH_TBB=ON \
      -D WITH_V4L=ON \
      -D WITH_QT=ON \
      -D WITH_OPENGL=ON ..

make -j$(nproc)
sudo make install

4단계: OpenBR 소스 빌드 및 설치

이제 모든 의존성이 준비되었으므로 OpenBR 소스 코드를 내려받아 빌드를 시작합니다. 서브모듈 동기화 과정이 포함됩니다.

git clone https://github.com/biometrics/openbr.git
cd openbr
git checkout master
git submodule init
git submodule update

mkdir build && cd build
cmake -DCMAKE_PREFIX_PATH=/opt/Qt5.3.2/5.3/gcc_64 \
      -DOpenCV_DIR=/usr/local/share/OpenCV \
      -DCMAKE_BUILD_TYPE=Release ..

make -j$(nproc)
sudo make install

5단계: 설치 확인 및 문서 생성(선택 사항)

설치가 완료된 후 정상 작동 여부를 테스트하거나 라이브러리 문서를 생성할 수 있습니다.

테스트 실행:

cd openbr/scripts
./downloadDatasets.sh
cd ../build
make test

문서 빌드:

sudo apt-get install doxygen
cd openbr/build
cmake -DBR_BUILD_DOCUMENTATION=ON ..
make -j4
# 빌드 완료 후 html/index.html 파일을 브라우저로 확인

OpenBR은 설치 과정이 까다롭지만, 한 번 구축되면 강력한 안면 인식 및 특징 추출 기능을 C++, 전용 알고리즘 문법 또는 커맨드라인 인터페이스를 통해 효율적으로 활용할 수 있습니다.

태그: OpenBR Facial Recognition OpenCV Qt5 cmake

7월 28일 22:49에 게시됨

괴물 클럽