State-of-the-art face detection and landmarks localization
Project description
Face Detector
This python package provides state-of-the-art face detection as well as face landmark points localization. It gathers the techniques implemented in dlib and mtcnn[], which can be easily switched between by setting a parameter in the FaceDetector class instantiation (mtcnn is default if no technique is specified, use fl_5 for dlib with 5 landmarks and fl_68 for dlib with 68 landmarks).
#How to Install:
pip install face-detector
How to Use:
from face_detector import FaceDetector
img_addr = "path/to/image.[jpg/png/jpeg ...]"
# First parameter in FaceDetector constructor specifies face detection method (dlib: fl_5 or fl_68, mtcnn is default: mtcnn)
face_detector = FaceDetector()
faces = face_detector.get_faces(img_addr)
# Or to get the most prominent face in photo
main_face = face_detector.get_main_face(img_addr)
# Show image with bounding boxes and landmarks
import cv2
img = cv2.imread(img_addr)
for face in faces:
bb = face.bounding_box
landmarks = face.landmarks
cv2.rectangle(img, (int(bb.x), int(bb.y)), (int(bb.x + bb.w), int(bb.y+bb.h)), (0, 255, 0), 1)
for l in landmarks:
cv2.circle(img, (l.x, l.y), 2, (0,0,255))
cv2.imshow('img', img)
cv2.waitKey(0)
cv2.destroyAllWindows()
[//]: <> - From Github:
[//]: <> - Clone this repository
[//]: <> - Install dependencies in requirements.txt:
[//]: <> - pip install -r requirements.txt
[//]: <> - You might need to install zlib and link it to /usr/lib/x86_64-linux-gnu/libz.so:
[//]: <> console [//]: <> foo@bar:~/face_detector$ tar xzvf data/zlib-1.2.9.tar.gz [//]: <> foo@bar:~/face_detector$ cd data/zlib [//]: <> foo@bar:~/face_detector/data/zlib$ sudo ./configure && make && make install [//]: <> foo@bar:~/face_detector/data/zlib$ ln -s /lib/x86_64-linux-gnu/libz.so.1.2.8 /usr/lib/x86_64-linux-gnu/libz.so [//]: <>
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for face_detector-0.2.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4dc6974a92236464f73edf2eb0fc57250bd68c5d0d4fceed8a15854d7bfa53ce |
|
MD5 | 6c926178a71fff1bf1d5eb857827f053 |
|
BLAKE2b-256 | b404a80d7b7cfc9980b939a8689f36a6be801f46818d9ca81161af904c9edfa5 |