{"id":17602472,"url":"https://github.com/johnwmillr/activeshapemodels","last_synced_at":"2025-04-12T10:30:39.862Z","repository":{"id":131245987,"uuid":"85099847","full_name":"johnwmillr/ActiveShapeModels","owner":"johnwmillr","description":"Face detection using active shape models 🐍","archived":false,"fork":false,"pushed_at":"2024-05-13T02:59:45.000Z","size":15070,"stargazers_count":45,"open_issues_count":1,"forks_count":18,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-26T05:22:35.246Z","etag":null,"topics":["active-shape-models","asm","face-detection","image-processing","shape"],"latest_commit_sha":null,"homepage":"","language":"MATLAB","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/johnwmillr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"johnwmillr"}},"created_at":"2017-03-15T17:10:02.000Z","updated_at":"2024-10-21T07:10:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"3698bdcc-9f8f-46b9-836f-6cfa41cd8e4f","html_url":"https://github.com/johnwmillr/ActiveShapeModels","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnwmillr%2FActiveShapeModels","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnwmillr%2FActiveShapeModels/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnwmillr%2FActiveShapeModels/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnwmillr%2FActiveShapeModels/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johnwmillr","download_url":"https://codeload.github.com/johnwmillr/ActiveShapeModels/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248552963,"owners_count":21123346,"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":["active-shape-models","asm","face-detection","image-processing","shape"],"created_at":"2024-10-22T13:08:28.911Z","updated_at":"2025-04-12T10:30:39.617Z","avatar_url":"https://github.com/johnwmillr.png","language":"MATLAB","funding_links":["https://github.com/sponsors/johnwmillr"],"categories":[],"sub_categories":[],"readme":"# Active Shape Models for face detection\r\n![](/Media/Faces_MultiResolution_horizontal.png \"Variations in the gray-level model\")\r\n\r\nThis project was part of my work for *Advanced Digital Image Processing* at the University of Iowa during spring 2017. You can read my [final report for the class here](/Media/ADIP_ActiveShapeModels_FinalReport.pdf). The report was a tad rushed, my apologies!\r\n\r\n![](/Media/Video/ASM_FaceDetection_24-Jul-2017_MUCT.gif \"Finding a face using the MUCT layout\")\r\n\r\n## Usage ##\r\nAfter cloning this repository, run the [Example_FindFace](Example_FindFace.m) script for a walkthrough demonstration of how to use this ASM code for locating a face in an example image.\r\n\r\n## More than just faces ##\r\nIt's probably worth pointing out that the ASM technique (and this implementation) is *not* limited to face detection. The models can be trained to detect whatever class of shapes the user chooses. So if you have a set of labeled images of hands (or whatever), you can train a model using the `buildShapeModel.m` and `buildGrayLevelModel.m` functions to search for hands (or whatever).\r\n\r\n## Background ##\r\nHere is the original [Cootes et al. paper.](http://www.sciencedirect.com/science/article/pii/S1077314285710041) PDFs of the paper are available elsewhere online if you don't have access to the journal. Here is a link to the [faces training set](http://robotics.csie.ncku.edu.tw/Databases/FaceDetect_PoseEstimate.htm#Our_Database_) I annotated to train my model.\r\n\r\nManipulating the weights on the 1st and 2nd principal components deforms the face shape within an allowable range of variation.\r\n\r\n\u003cimg src=\"/Media/Faces_PC_Variations.png\" width=\"800\"\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnwmillr%2Factiveshapemodels","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnwmillr%2Factiveshapemodels","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnwmillr%2Factiveshapemodels/lists"}