{"id":19237695,"url":"https://github.com/adamouization/binary-image-classifier","last_synced_at":"2025-02-23T13:51:10.132Z","repository":{"id":78089095,"uuid":"84313144","full_name":"Adamouization/Binary-Image-Classifier","owner":"Adamouization","description":" :black_large_square: :white_large_square: Binary Image Classifier using Gaussian Mixture Models written in MatLab (2017)","archived":false,"fork":false,"pushed_at":"2018-04-20T16:37:06.000Z","size":1779,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-05T01:43:24.696Z","etag":null,"topics":["artificial-intelligence","binary-image","classifier","matlab","matlab-script","pattern","pattern-classification","pattern-matching","pattern-recognition"],"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/Adamouization.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2017-03-08T11:29:39.000Z","updated_at":"2020-05-26T14:42:46.000Z","dependencies_parsed_at":"2023-04-20T10:34:27.285Z","dependency_job_id":null,"html_url":"https://github.com/Adamouization/Binary-Image-Classifier","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adamouization%2FBinary-Image-Classifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adamouization%2FBinary-Image-Classifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adamouization%2FBinary-Image-Classifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Adamouization%2FBinary-Image-Classifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Adamouization","download_url":"https://codeload.github.com/Adamouization/Binary-Image-Classifier/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240324060,"owners_count":19783453,"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":["artificial-intelligence","binary-image","classifier","matlab","matlab-script","pattern","pattern-classification","pattern-matching","pattern-recognition"],"created_at":"2024-11-09T16:27:51.997Z","updated_at":"2025-02-23T13:51:10.115Z","avatar_url":"https://github.com/Adamouization.png","language":"Matlab","readme":"Binary Image Classifier\n===========\n\nThis program is a classifier that is trained to classify labeled binary images (image bits can only have two values: 0 and 1 for black and white), also known as supervised training.\n\nThe classifier is trained by fitting a GMM (Gaussian Mixture Model) based on each image's feature vector from the training set, which will allow us to classify new binary images (different from the training set) using a Maximum a Posteriori classification technique by comparing each of the new images' feature vector to the ones stored in the GMM. \n\nThe results can be viewed in a confusion matrix, which is a table that is incremented after each new image has been classified. It allows us to visualize how many images have been correctly classified over the total set. \n\nAfter optimization by calculating the ideal feature vector length (8 was the chosen length), a classifying precision of **83%** was achieved.\n\nYou can read a more detailed explanation of how the classifier was built, optimized and the mathematics used here: [report](https://github.com/Adamouization/Binary-Image-Classifier/blob/master/report.pdf).\n\n\n## Screenshots\n\n###### Confusion matrix screenshot - assessing the classifier's quality\n\n![confusion matrix screenshot](https://github.com/Adamouization/Binary-Image-Classifier/blob/master/screenshots/confusion_matrix.png)\n\n###### Gaussian Mixture Model screenshot - the results of the classifier's training used to classify new images\n\n![GMM screenshot](https://github.com/Adamouization/Binary-Image-Classifier/blob/master/screenshots/GMM.png)\n\n\n## Usage\n\nClone this repository and open the project in MatLab:\n\n```\ngit clone https://github.com/Adamouization/Binary-Image-Classifier\n```\n\n#### MatLab application usage\n\nOnce you have the project opened in MatLab, move to the `src` directory and open the `script.m`. Run the `script.m` file directly from within MatLab\n\n#### Command line usage\n\nOnce you have cloned the repository, `cd` into `Binary-Image-Classifier/src` directory:\n\n```\ncd Binary-Image-Classifier/src\n```\n\nThen run the following command:\n\n```\n\"C:\\\u003cyour_local_matlab_path\u003e\\matlab.exe\" -nodisplay -nosplash -nodesktop -r \"run('script.m');\"\n```\n\nwhere `C:\\\u003cyour_local_matlab_path\u003e\\matlab.exe` is the path to your MatLab executable.\n\n## License \n* see [LICENSE](https://github.com/Adamouization/Binary-Image-Classifier/blob/master/LICENSE) file\n\n## Contact\n\n* email: adam@jaamour.com\n* website: www.adam.jaamour.com\n* twitter: [@Adamouization](https://twitter.com/Adamouization)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamouization%2Fbinary-image-classifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadamouization%2Fbinary-image-classifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamouization%2Fbinary-image-classifier/lists"}