{"id":24849015,"url":"https://github.com/gigacycle/extract3dfacelandmarks","last_synced_at":"2025-03-26T11:13:09.217Z","repository":{"id":238486725,"uuid":"796659411","full_name":"gigacycle/Extract3DFaceLandmarks","owner":"gigacycle","description":"This project extracts 3D face landmarks based on 2d screenshots of a 3D face (Lateral Left, Lateral Right and Front View)","archived":false,"fork":false,"pushed_at":"2024-05-13T11:03:03.000Z","size":6256,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-31T12:19:00.954Z","etag":null,"topics":["3d-landmark","3d-landmarks","face-alignment","face-landmark","python","vedo"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gigacycle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-05-06T11:38:04.000Z","updated_at":"2024-10-15T06:29:15.000Z","dependencies_parsed_at":"2024-05-13T12:40:08.783Z","dependency_job_id":null,"html_url":"https://github.com/gigacycle/Extract3DFaceLandmarks","commit_stats":null,"previous_names":["gigacycle/extract3dfacelandmarks"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gigacycle%2FExtract3DFaceLandmarks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gigacycle%2FExtract3DFaceLandmarks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gigacycle%2FExtract3DFaceLandmarks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gigacycle%2FExtract3DFaceLandmarks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gigacycle","download_url":"https://codeload.github.com/gigacycle/Extract3DFaceLandmarks/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245641438,"owners_count":20648644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-landmark","3d-landmarks","face-alignment","face-landmark","python","vedo"],"created_at":"2025-01-31T12:19:00.405Z","updated_at":"2025-03-26T11:13:09.197Z","avatar_url":"https://github.com/gigacycle.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Extract3DFaceLandmarks\n\nThis Python project extracts 3D landmarks based on 2D screenshots of a 3D face, including Lateral Left, Lateral Right, and Front View. It has undergone testing with the ESRC dataset curated by Peter Hancock at Stirling and Bernie Tiddeman at Aberystwyth. You can find his work [here](https://pics.stir.ac.uk/ESRC/index.htm).\n\n![M1000_N](https://github.com/gigacycle/Extract3DFaceLandmarks/assets/2722068/c4671286-393b-4a74-91ad-720554ffb7b2)\n\nBefore utilizing this project, ensure that the facial object is aligned with the Frankfort Horizontal Plane. Detailed instructions on this alignment process can be found [here](https://www.otoscape.com/eponyms/frankfort-horizontal-plane.html). Note that all ESRC 3D Faces are already aligned with the Frankfort Horizontal Plane.\n\n## Installation\n\nBegin by cloning the project with the following command:\n\n```bash\ngit clone https://github.com/gigacycle/Extract3DFaceLandmarks.git\n```\n\nNext, install the required dependencies using the following command:\n\n```bash\npip install face-alignment, torchvision, vedo\n```\n\n## Usage\n\nAfter successfully cloning the project and installing the dependencies, Run `main.py` and follow the instructions.\n\n![VisualzeExtractedLandmarks](https://github.com/gigacycle/Extract3DFaceLandmarks/assets/2722068/73ac0941-3b76-404a-adb1-e481b7ce8d60)\n\n1. Starts extracting 3D landmarks for ESRC dataset (stores at ./dataset/)\n2. Starts extracting your own 3D face object (it needs full path of your .obj) and displays the landmarks at the end.\n3. Displays the landmarks extracted in phase `1` (you should type the item name like the picture above)\n\n## Acknowledgements\n\nThis project leverages the face-alignment and vedo libraries. \n\n- Face-alignment: [Link to the project](https://github.com/1adrianb/face-alignment)\n- Vedo: [Link to the website](https://vedo.embl.es/)\n\nPlease ensure proper citation of these projects in your work.\n\nContributions to this project are welcomed via the submission of issues or pull requests.\n\nFor inquiries or assistance, kindly contact me.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgigacycle%2Fextract3dfacelandmarks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgigacycle%2Fextract3dfacelandmarks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgigacycle%2Fextract3dfacelandmarks/lists"}