# Mini-face
## Installation with pip
> Requirements: `python 3.12`, `numpy >= 1.21`.
1. Install the package with a following command:
```
python3 -m pip install mini-face
```
2. Download model data files (subdirectories **/model/** and **/AU_predictors/**) from this repository or official
<a href="https://github.com/TadasBaltrusaitis/OpenFace/releases" title="OpenFace releases">OpenFace release</a>.
You will also need files from <a href="https://github.com/TadasBaltrusaitis/OpenFace/wiki/Model-download" title="OpenFace models">here</a>.
## Python usage
Below is a minimalist example of using the module from Python code:
```
import cv2
import numpy as np
from mini_face import GazeFeatureExtractor
from mini_face import PredictionMode
if __name__ == "__main__":
image = cv2.imread("test_image.jpg")
extractor = GazeFeatureExtractor(
mode=PredictionMode.IMAGE,
focal_length=(500, 500),
optical_center=(860.0, 540.0),
models_directory="./model",
)
result = extractor.predict(image, np.array([0.0, 0.0, 1080.0, 1920.0]))
print(f"{result = }")
```
Raw data
{
"_id": null,
"home_page": null,
"name": "mini-face",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "OpenFace, vcpkg, pybind11, scikit-build, cpp",
"author": null,
"author_email": "Igor Swat <iswat@student.agh.edu.pl>, Jan Sm\u00f3\u0142ka <jp.smolka@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/07/28/86bd137593b39257db0399ebe01221068603ebe4820839da4ea62bf4c1b0/mini_face-0.1.0.tar.gz",
"platform": null,
"description": "# Mini-face\r\n\r\n## Installation with pip\r\n> Requirements: `python 3.12`, `numpy >= 1.21`.\r\n1. Install the package with a following command:\r\n```\r\n python3 -m pip install mini-face\r\n```\r\n2. Download model data files (subdirectories **/model/** and **/AU_predictors/**) from this repository or official\r\n <a href=\"https://github.com/TadasBaltrusaitis/OpenFace/releases\" title=\"OpenFace releases\">OpenFace release</a>.\r\n You will also need files from <a href=\"https://github.com/TadasBaltrusaitis/OpenFace/wiki/Model-download\" title=\"OpenFace models\">here</a>.\r\n\r\n## Python usage\r\nBelow is a minimalist example of using the module from Python code:\r\n\r\n```\r\n import cv2\r\n import numpy as np\r\n from mini_face import GazeFeatureExtractor\r\n from mini_face import PredictionMode\r\n\r\n if __name__ == \"__main__\":\r\n image = cv2.imread(\"test_image.jpg\")\r\n extractor = GazeFeatureExtractor(\r\n mode=PredictionMode.IMAGE,\r\n focal_length=(500, 500),\r\n optical_center=(860.0, 540.0),\r\n models_directory=\"./model\",\r\n )\r\n\r\n result = extractor.predict(image, np.array([0.0, 0.0, 1080.0, 1920.0]))\r\n\r\n print(f\"{result = }\")\r\n```\r\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License",
"summary": "A minimalist Python wrapper for OpenFace library",
"version": "0.1.0",
"project_urls": {
"repository": "https://github.com/child-lab-uj/mini-face"
},
"split_keywords": [
"openface",
" vcpkg",
" pybind11",
" scikit-build",
" cpp"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "82db92a88c767e40662bb923ce76db1dbc26ef771917c1922397aca110a0e097",
"md5": "5bcb1556fc036a5c4352d7de834fa10e",
"sha256": "98087280df7e65b015b4379b3aeab01edc59ac8a8b74c9a8157528e68e2d1a34"
},
"downloads": -1,
"filename": "mini_face-0.1.0-cp312-cp312-win_amd64.whl",
"has_sig": false,
"md5_digest": "5bcb1556fc036a5c4352d7de834fa10e",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.12",
"size": 14603569,
"upload_time": "2024-10-02T17:38:30",
"upload_time_iso_8601": "2024-10-02T17:38:30.823366Z",
"url": "https://files.pythonhosted.org/packages/82/db/92a88c767e40662bb923ce76db1dbc26ef771917c1922397aca110a0e097/mini_face-0.1.0-cp312-cp312-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "072886bd137593b39257db0399ebe01221068603ebe4820839da4ea62bf4c1b0",
"md5": "088755e47cedcbdf630e2d81ce53e79e",
"sha256": "07d6e35e3abf00197d169688c33107bcbd1e79f7cd7c75962be096102c5004b7"
},
"downloads": -1,
"filename": "mini_face-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "088755e47cedcbdf630e2d81ce53e79e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 14536148,
"upload_time": "2024-10-02T17:38:34",
"upload_time_iso_8601": "2024-10-02T17:38:34.825627Z",
"url": "https://files.pythonhosted.org/packages/07/28/86bd137593b39257db0399ebe01221068603ebe4820839da4ea62bf4c1b0/mini_face-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-02 17:38:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "child-lab-uj",
"github_project": "mini-face",
"github_not_found": true,
"lcname": "mini-face"
}