Python pakage for detecting largest face in an image
Project description
Largest Face Detector
The Largest Face Detector is a basic face detector that detects largest frontal face from image using external python dlib library (http://dlib.net/python/index.html).
Installation
You can install the Largest Face Detector from PyPI:
pip install largest-frontal-face-detector
The reader is supported on Python 3.6 and above.
Pre-requisites
1. numpy (pip install numpy)
2. dlib (pip install dlib)
3. PIL (pip install pillow)
NOTE :: These dependency packages will be installed automatically upon installing largest-face-detector package.
How to use
The Largest Face Detector is a pip package, named largest_face_detector
. To detect face in a particular image, call the function detect_largest_face
with image path as input (relative to current directory you are in)
>>> import largest_face_detector
>>> image = largest_face_detector.detect_largest_face('image.jpeg')
$ Cropped face saved successfully at : /Users/kulshd/2019-10-05T14:08:20.086934_cropped_image.jpeg
The function will return the cropped image as a 2D numpy array and also save it.
Following are some requirements and assumptions for using this package -
1. Image size must be within [1024,1024]. If it exceeds, NotImplementedError is raised.
2. If no face is detected by the package, a warning message is displayed
3. Currently following image formats are supported - [.jpeg, .jpg, .png]
You can also run test-cases to validate package functionality by downloading source .tar.gz file (https://pypi.org/project/largest-frontal-face-detector/0.0.3/#files),extracting and cd into folder largest_frontal_face_detector-0.0.2, and running python3 -m unittest discover -v
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for largest_frontal_face_detector-0.0.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5d7c4e009b8fb1aa38a1e869d0b94155ff1ffa5ce360cb2211175fc3c32fc2c4 |
|
MD5 | 6c47d5a251b49eac3d03d0813913651b |
|
BLAKE2b-256 | fccf3a1eec70b1c4add297541b2a6a91827b5ad62ae865ab42841e786905dae2 |
Hashes for largest_frontal_face_detector-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | be6d21675a1004ecfab5f4714b397a1f946669e6e1dd9de92a9e28f8b75c97d2 |
|
MD5 | 1f2c0cc090ad710bcc6839bb4f67d2d6 |
|
BLAKE2b-256 | 9d1a1edf4147c44d30af83bcf00c06a3fba0302cd7e602d47032ad8819967965 |