Deepface

🌟 Release Notes: Enhancements & Fixes 🌟

🎯 All detectors now return a confidence score between 0 and 1 (https://github.com/serengil/deepface/pull/1041)

📏 Fixed the "expand facial area" logic – it was doubling the expand_percentage for width and height instead of applying it correctly. Now, it's just right. (https://github.com/serengil/deepface/pull/1047)

🔄 Ensured rotation angles are now nicely constrained within a [0, 360) range, keeping things in a perfect circle. (https://github.com/serengil/deepface/pull/1047)

🚫💬 Added meaningful error messages for when a face can't be detected for a given a numpy array or base64 encoded image. (https://github.com/serengil/deepface/pull/1059)

🚀 Optimized the verify function to avoid unnecessary recalculations of embeddings when multiple faces are detected in one of the image pairs. (https://github.com/serengil/deepface/pull/1059)

🌐 Loading images from web if and only if given image is really link, discarding files with name starting with http prefix (https://github.com/serengil/deepface/pull/1059)

🔍 In the find function, we're now checking the type of base64 encoded images to ensure compatibility with jpg, jpeg, and png formats. (https://github.com/serengil/deepface/pull/1059)

🚨 The fastmtcnn detector has been fixed to gracefully handle cases where no face is detected. (https://github.com/serengil/deepface/pull/1059)

🔄 Verify function now gracefully accepts pre-calculated embeddings as inputs. (https://github.com/serengil/deepface/pull/1072)

📊 We're now including column names in the output pickle files of the file function for that extra clarity and convenience. (https://github.com/serengil/deepface/pull/1072)

🔍📁 In find function, we are now tracking replaced files in a folder (https://github.com/serengil/deepface/pull/1072, https://github.com/serengil/deepface/pull/1074)

🛠️ Updated GitHub Actions configuration to wave goodbye to those pesky warnings. Smooth sailing ahead! (https://github.com/serengil/deepface/pull/1082)

🤖 We now check the TensorFlow version in DeepFace model to avoid issues with LocallyConnected2D not being supported after tf 2.12. Ensuring smooth imports and no surprises! (https://github.com/serengil/deepface/pull/1083)

🚀 Release Notes - Version 0.0.84 (Feb 04, 2024) 🚀

We are thrilled to announce the latest release, packed with exciting enhancements, bug fixes, and organizational improvements. Let's dive into the highlights of this release:

Features & Enhancements:

🛠️ **Error Prevention in MTCNN Detector**: Resolved a TypeError when running the MTCNN detector on an image with no faces. A condition using short-circuit evaluation has been added to prevent this exception. (https://github.com/serengil/deepface/pull/976)

📸 **Updated Return Type for Face Detection**: Modified the return type of Detector.detect_faces and its inherited classes to improve clarity. Now returning a List[DetectedFace] where DetectedFace includes the detected image, facial area coordinates, and face confidence score. (https://github.com/serengil/deepface/pull/978)

📁 **API Restructuring**: Moved the API under the 'deepface' folder for better organization. Unit tests have been added to ensure the reliability of the API functionalities. (https://github.com/serengil/deepface/pull/1004)

🐞 **Bug Fix in API Serialization**: Resolved the bug causing "Object of type int32 is not JSON serializable" in the API. Converted facial area regions from numpy int32 to Python built-in int. (https://github.com/serengil/deepface/pull/1004)

🔄 **Facial Area Expansion**: Added an 'expand facial area percentage' argument to all functions for greater flexibility. (https://github.com/serengil/deepface/pull/990)

🛠️ **Code Refactoring and Organization**: Retired the 'find target size' function, moving facial recognition model input shapes retrieval to clients. Created a preprocessing module, relocated load image functions, and organized code logic into separate modules. (https://github.com/serengil/deepface/pull/990)

🐍 **Snake Case for Distance Calculation**: Made distance calculation functions snake-cased for consistency. (https://github.com/serengil/deepface/pull/990)

📦 **Commons Module Refactoring**: Retired commons.function in favor of commons.package_utils and commons.version_utils. The logic previously available under function.commons has been moved to the appropriate modules. (https://github.com/serengil/deepface/pull/999)

Documentation & Miscellaneous:

📖 **Citations Added**: Included a citations.md file for easy access to citations and references. (https://github.com/serengil/deepface/pull/999)

🧹 **Code Cleanup and Restructuring**: Distance calculation functions have been moved into the verification module. Version information is now stored in package_info.json. The Postman collection is now located under api/postman. (https://github.com/serengil/deepface/pull/999)

We appreciate your continued support and feedback. Please feel free to explore these improvements and let us know if you encounter any issues or have suggestions for further enhancements. Happy coding! 🚀✨

Packages

- https://pypi.org/project/deepface/0.0.84/

🔄 **Enhancement**

Find function now returns a pandas dataframe, with the distance column named as distance by default. Improved naming practice for clarity and consistency.[PR-974](https://github.com/serengil/deepface/pull/974)

Ticket: https://github.com/serengil/deepface/issues/969

🎯 **New Feature**

Added optional threshold argument to the find function. You can now filter the pandas dataframe after finding distances for each pair. If threshold is not set, the pre-tuned threshold will still be used for the given model name and distance metric. [PR-974](https://github.com/serengil/deepface/pull/974)

Ticket: https://github.com/serengil/deepface/issues/972

🐛 **Bug Fix**

Resolved yunet bug related to "Argument 'score_threshold' can't be treated as a float." The issue has been sorted out. [PR-974](https://github.com/serengil/deepface/pull/974)

Ticket: https://github.com/serengil/deepface/issues/973

Packages

- https://pypi.org/project/deepface/0.0.83/