Face Recognition

중국어 简体中文版 로 번역된 이 파일을 읽으실 수 있습니다.

세계에서 가장 간단한 얼굴 인식 라이브러리로, Python 또는 명령 줄에서 얼굴을 인식하고 조작 해 보십시오.

딥 러닝으로 구축된 dlib의 최첨단 얼굴 인식 기능을 사용하여 구축되었습니다. 이 모델은 Labeled Faces in the Wild 기준으로 99.38%의 정확도를 가집니다.

또한, 명령 줄에서 이미지 폴더 안에 있는 얼굴 인식 기능을 위한 간단한 face_recognition 명령 줄 도구를 제공합니다!

특징

사진에서 얼굴 찾기

사진에 등장하는 모든 얼굴들을 찾습니다:

import face_recognition
image = face_recognition.load_image_file("your_file.jpg")
face_locations = face_recognition.face_locations(image)

사진에 있는 얼굴의 특징을 찾기&조작하기

각각의 사람의 눈, 코, 입, 턱의 위치와 윤곽을 잡아냅니다.

import face_recognition
image = face_recognition.load_image_file("your_file.jpg")
face_landmarks_list = face_recognition.face_landmarks(image)

얼굴의 특징을 찾는 기능은 여러 중요한 일들에 유용하게 쓰입니다. 하지만 디지털 메이크업 (Meitu 같은 것)을 적용하는 것과 같은 정말 멍청한 것들에도 쓰일 수 있습니다:

사진 속 얼굴의 신원 확인하기

각각의 사진에서 누가 등장하였는지 인식합니다.

import face_recognition
known_image = face_recognition.load_image_file("biden.jpg")
unknown_image = face_recognition.load_image_file("unknown.jpg")

biden_encoding = face_recognition.face_encodings(known_image)[0]
unknown_encoding = face_recognition.face_encodings(unknown_image)[0]

results = face_recognition.compare_faces([biden_encoding], unknown_encoding)

이 라이브러리를 다른 Python 라이브러리와 함께 사용하여 실시간 얼굴 인식을 할 수도 있습니다:

코드에 대해서는 이 예제 를 참조하십시오.

온라인 데모

Jupyter notebook demo로 공유된 사용자 기여 (공식적인 지원이 아님):

설치

요구 사항

Python 3.3+ 또는 Python 2.7
macOS 또는 Linux (Windows는 공식적으로 지원하지 않으나, 작동할 수도 있음)

설치 옵션들:

Mac 또는 Linux에서의 설치

우선, 파이썬 바인딩을 통해 dlib이 이미 설치가 되어있는지를 확인해야 합니다:

macOS 또는 Ubuntu에서 소스에서 dlib을 설치하는 방법

다음으로, pip3 (또는 Python2의 경우 pip2)을 사용하여 pypi에서의 모듈을 설치하십시오:

pip3 install face_recognition

또는, 이 부분을 참조하여, Docker로 이 라이브러리를 시도해보십시오.

설치에 대해 문제가 발생하였으면, 미리 구성된 VM을 사용해 볼 수도 있습니다.

Raspberry Pi 2+에서의 설치

Raspberry Pi 2+ 설치 설명서

Windows에서 설치하기

Windows는 공식적으로 지원하지는 않지만, 친절한 유저들이 이 라이브러리를 어떻게 설치하는지 설명서를 작성했습니다:

@masoudr의 Windows 10 설치 가이드 (dlib + face_recognition)

미리 구성된 가상머신 이미지(VM)를 설치하기

미리 구성된 VM 이미지를 다운로드하기 (VMware Player 또는 VirtualBox용).

사용법

명령 줄 인터페이스

face_recognition을 설치하면, 두 가지 간단한 명령 줄 프로그램을 얻습니다:

face_recognition - 사진이나 사진으로 가득 찬 폴더의 얼굴을 인식합니다.
face_detection - 사진이나 사진으로 가득 찬 폴더에서 얼굴을 찾습니다.

`face_recognition` 명령 줄 도구

face_recognition 명령을 사용하면 사진이나 사진으로 가득 찬 폴더의 얼굴을 인식할 수 있습니다.

먼저, 이미 알고 있는 각 사람의 사진 한 장이 폴더에 있어야 합니다. 그리고 사진 속에 있는 그 사람의 이름을 딴 이미지 파일이 각각 하나씩 있어야 합니다:

다음으로, 식별할 파일이 있는 두 번째 폴더가 필요합니다:

그런 다음, 알고 있는 사람의 폴더와 모르는 사람의 폴더(또는 단일 이미지)를 전달하는 face_recognition 명령을 실행하면, 각 이미지에 있는 사람을 알 수 있습니다:

$ face_recognition ./pictures_of_people_i_know/ ./unknown_pictures/

/unknown_pictures/unknown.jpg,Barack Obama
/face_recognition_test/unknown_pictures/unknown.jpg,unknown_person

각각의 얼굴의 결과에는 하나의 줄이 있습니다. 데이터는 파일 이름과 찾아낸 사람의 이름으로 쉼표로 구분됩니다.

unknown_person은 이미지 속에 알고 있는 사람의 폴더에 있는 사람과 일치하지 않는 얼굴입니다.

`face_detection` 명령 줄 도구

face_detection 명령을 사용하면 이미지에서 얼굴의 위치 (픽셀 좌표)를 찾을 수 있습니다.

face_detection 명령을 실행하여 검사 할 이미지 폴더 (또는 단일 이미지)를 전달하십시오:

$ face_detection  ./folder_with_pictures/

examples/image1.jpg,65,215,169,112
examples/image2.jpg,62,394,211,244
examples/image2.jpg,95,941,244,792

감지된 각 얼굴에 대해 한 줄씩 인쇄합니다. 보고 된 좌표는 얼굴의 위쪽, 오른쪽, 아래쪽 및 왼쪽 좌표 (픽셀 단위)입니다.

오차 조절 / 민감도

같은 사람에 대해 여러 개의 항목을 얻었다면, 사진에 있는 사람들이 매우 유사하게 보이기 때문이며 얼굴 비교를 더욱 엄격하게 하기 위해 낮은 허용치가 필요합니다.

--tolerance 변수를 이용하여 이를 수행할 수 있습니다. 기본 허용치 값은 0.6이며 숫자가 낮으면 얼굴 비교가 더욱 엄격해집니다:

$ face_recognition --tolerance 0.54 ./pictures_of_people_i_know/ ./unknown_pictures/

/unknown_pictures/unknown.jpg,Barack Obama
/face_recognition_test/unknown_pictures/unknown.jpg,unknown_person

관용 설정을 조정하기 위해 계산된 얼굴 거리는 --show-distance true를 통해 볼 수 있습니다:

$ face_recognition --show-distance true ./pictures_of_people_i_know/ ./unknown_pictures/

/unknown_pictures/unknown.jpg,Barack Obama,0.378542298956785
/face_recognition_test/unknown_pictures/unknown.jpg,unknown_person,None

더 많은 예제들

각 사진에 있는 사람들의 이름은 알고 싶지만 파일 이름에는 신경 쓰지 않는다면 다음과 같이 할 수 있습니다:

$ face_recognition ./pictures_of_people_i_know/ ./unknown_pictures/ | cut -d ',' -f2

Barack Obama
unknown_person

얼굴 인식 속도 향상

여러 개의 CPU 코어가 있는 컴퓨터를 사용한다면, 얼굴 인식을 동시에 수행 할 수 있습니다. 예를 들면, 4개의 CPU 코어가 있는 환경에서는, 모든 CPU 코어를 병렬로 사용하여 같은 시간 동안 약 4배의 양으로 이미지를 처리할 수 있습니다.

Python 3.4 이상을 사용하는 경우 --cpus <number_of_cpu_cores_to_use> 매개 변수를 전달하십시오:

$ face_recognition --cpus 4 ./pictures_of_people_i_know/ ./unknown_pictures/

--cpus -1을 전달하여 시스템의 모든 CPU 코어를 사용할 수도 있습니다.

Python 모듈

face_recognition 모듈을 추가하여 몇 줄의 코드만으로 얼굴 조작을 쉽게 할 수 있습니다. 이는 매우 간단합니다!

API 문서: https://face-recognition.readthedocs.io.

이미지의 모든 얼굴을 자동으로 찾기

import face_recognition

image = face_recognition.load_image_file("my_picture.jpg")
face_locations = face_recognition.face_locations(image)

# face_locations is now an array listing the co-ordinates of each face!

이 예제 를 사용하여 테스트 해 보십시오.

좀 더 정확한 딥 러닝 기반의 얼굴 탐지 모델을 채택할 수도 있습니다.

참고: 이 모델의 성능을 높이려면 (NVidia의 CUDA 라이브러리를 통한)GPU 가속이 필요합니다. 또한 dlib을 컴파일링할 때 CUDA 지원을 활성화 할 수 있습니다.

import face_recognition

image = face_recognition.load_image_file("my_picture.jpg")
face_locations = face_recognition.face_locations(image, model="cnn")

# face_locations is now an array listing the co-ordinates of each face!

이 예제 를 사용하여 테스트 해 보십시오.

이미지와 GPU가 둘 다 많은 경우, 얼굴을 일괄적으로 찾을 수도 있습니다.

이미지에서 사람의 얼굴 특징으로 자동으로 찾기

import face_recognition

image = face_recognition.load_image_file("my_picture.jpg")
face_landmarks_list = face_recognition.face_landmarks(image)

# face_landmarks_list is now an array with the locations of each facial feature in each face.
# face_landmarks_list[0]['left_eye'] would be the location and outline of the first person's left eye.

이 예제 를 사용하여 테스트 해 보십시오.

이미지에서 얼굴을 인식하고 누구인지 식별하기

import face_recognition

picture_of_me = face_recognition.load_image_file("me.jpg")
my_face_encoding = face_recognition.face_encodings(picture_of_me)[0]

# my_face_encoding now contains a universal 'encoding' of my facial features that can be compared to any other picture of a face!

unknown_picture = face_recognition.load_image_file("unknown.jpg")
unknown_face_encoding = face_recognition.face_encodings(unknown_picture)[0]

# Now we can see the two face encodings are of the same person with `compare_faces`!

results = face_recognition.compare_faces([my_face_encoding], unknown_face_encoding)

if results[0] == True:
    print("It's a picture of me!")
else:
    print("It's not a picture of me!")

이 예제 를 사용하여 테스트 해 보십시오.

Python 코드 예제

모든 예제는 여기 에 있습니다.

얼굴 탐지

사진에서 얼굴 찾기
사진에서 얼굴 찾기(딥 러닝 사용)
이미지 모음에서 얼굴 찾기 w/ GPU (딥 러닝 사용)
웹캠을 사용하여 라이브 비디오의 모든 얼굴을 흐리게 처리하기 (OpenCV가 설치되어 있어야 함)

얼굴의 특징

사진의 특정 얼굴 특징 확인하기
Apply (horribly ugly) digital make-up

얼굴 인식

알고있는 사람들의 사진을 기반으로 사진에서 알 수 없는 얼굴을 찾고 인식하기
사진 안의 각 사람들을 식별하고 주의에 상자를 그리기
얼굴 구분을 참/거짓 구분 대신 숫자로 비교하기
웹캠을 사용하여 라이브 비디오의 얼굴 인식하기 - 간단함 / 느린 버전 (OpenCV가 설치되어 있어야 함)
웹캠을 사용하여 라이브 비디오의 얼굴 인식하기 - 빠른 버전 (OpenCV가 설치되어 있어야 함)
비디오 파일에서 얼굴을 인식하고 새 비디오 파일을 작성하기 (OpenCV가 설치되어 있어야 함)
Raspberry Pi w/ camera에서의 얼굴 인식하기
HTTP를 통해 얼굴을 인식하는 웹 서비스 실행하기 (Flask가 설치되어 있어야 함)
K-nearest neighbors classifier를 통한 얼굴 인식하기

독립적인 실행 파일 만들기

Python이나 face_recognition을 설치할 필요 없이 실행할 수 있는 독립적인 실행형 실행 파일을 만들려면 PyInstaller 를 사용하면 됩니다. 그러나, 이 라이브러리로 작업하려면 어느 정도의 설정 커스텀이 필요합니다. 방법에 대해서는 이 이슈 를 참조하십시오.