{"id":15546715,"url":"https://github.com/hokagem/byakuganvisualizer","last_synced_at":"2026-01-21T16:02:32.132Z","repository":{"id":230256378,"uuid":"778860883","full_name":"HokageM/ByakuganVisualizer","owner":"HokageM","description":"The ByakuganVisualizer repository hosts a Python tool designed to compare images and highlight their differences. It simplifies the process of identifying disparities between images, making it ideal for tasks like testing and quality assurance. Moreover, it offers a color filter that can be used to correct images for color-blind users.","archived":false,"fork":false,"pushed_at":"2024-04-30T09:52:21.000Z","size":616,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-09T13:13:07.234Z","etag":null,"topics":["color-blind","color-correction","colorblind","image-manipulation","numpy","pillow"],"latest_commit_sha":null,"homepage":"","language":"Python","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/HokageM.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":"2024-03-28T14:54:16.000Z","updated_at":"2024-04-30T09:52:05.000Z","dependencies_parsed_at":"2024-04-30T11:07:44.341Z","dependency_job_id":"e899ef6b-7846-44f3-834c-5f62929f8fda","html_url":"https://github.com/HokageM/ByakuganVisualizer","commit_stats":{"total_commits":30,"total_committers":2,"mean_commits":15.0,"dds":0.09999999999999998,"last_synced_commit":"fd749b501978f0da20867d5b65d19bbf0c8bba3c"},"previous_names":["hokagem/byakuganvisualizer"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HokageM%2FByakuganVisualizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HokageM%2FByakuganVisualizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HokageM%2FByakuganVisualizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HokageM%2FByakuganVisualizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HokageM","download_url":"https://codeload.github.com/HokageM/ByakuganVisualizer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238585201,"owners_count":19496435,"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":["color-blind","color-correction","colorblind","image-manipulation","numpy","pillow"],"created_at":"2024-10-02T13:03:47.875Z","updated_at":"2026-01-21T16:02:32.103Z","avatar_url":"https://github.com/HokageM.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ByakuganVisualizer\n\n\u003cimg src=\"logo/logo.jpeg\" width=\"200\"\u003e\n\nThe ByakuganVisualizer repository hosts a Python tool designed to compare images and highlight their differences.\nIt simplifies the process of identifying disparities between images, making it ideal for tasks like testing and quality \nassurance.\nMoreover, it offers a color filter that can be used to correct images for **color-blind users**.\n\n\n## Installation\n\n```bash\npip install byakuganvisualizer\n```\n\n## Usage \n\n### Command Line Interface\n\n```\nusage: byakugan_vision [-h] [--version] [--diff DIFF] [--filter {red,blue,green,yellow}] [--images IMAGES] [--deuteranomaly DEUTERANOMALY]\n                       [--protanomaly PROTANOMALY] [--out_dir OUT_DIR]\n\nByakuganVisualizer: Tool for correcting the color palett for color blind people and highlighting differences of images.\n\noptions:\n  -h, --help            show this help message and exit\n  --version             show program's version number and exit\n  --diff DIFF           String containing a list of tuples \"Path_To_Image1a,Path_To_Image2a;Path_To_Image1b,Path_To_Image2b...\". Each tuple\n                        contains two paths to images to be compared.\n  --filter {red,blue,green,yellow}\n                        Filter type (red, blue, green, yellow)\n  --images IMAGES       List of image names to be manipulated by a filter. E.g.: A,B,C,D\n  --deuteranomaly DEUTERANOMALY\n                        Expresses your degree of deuteranomaly, which will be used to correct the image. Default is 1.\n  --protanomaly PROTANOMALY\n                        Expresses your degree of protanomaly, which will be used to correct the image. Default is 1.\n  --out_dir OUT_DIR     Output directory for the difference images\n```\n\n### Python API\n\nPlease read the API documentation for the classes `Byakugan` and `ImageFilter` for more information.\nYou can simply import the classes as follows:\n\n```python\nfrom byakuganvisualizer.Byakugan import Byakugan\nfrom byakuganvisualizer.ImageFilter import ImageFilter\n```\n\n\n## Image Correction for Color Blind People\n\nIn the following examples the image is corrected for deuteranomaly and protanomaly. \nCorrection in this context means that the image is adjusted to be more distinguishable for color-blind people.\n\n**Note:** The float values for deuteranomaly and protanomaly are between 0 and 10. The default value is 1.\nThe used algorithm is based on the following paper: https://arxiv.org/abs/1711.10662.\n\nThe image used in the example is from the following source:\nhttps://www.anime2you.de/news/606180/naruto-feiert-20-anime-jubilaeum/\n\n\u003cimg src=\"tests/test_images/naruto.jpg\" style=\"width: 200px\"\u003e\n\n### Deuteranomaly Correction\n\n```bash\nbyakugan_vision --images \"tests/test_images/naruto.jpg\" --deuteranomaly 2\n```\n\n\u003cimg src=\"tests/test_images/filtered/Filtered_naruto_deuteranomaly_2_protanomaly_0.jpg\" style=\"width: 200px\"\u003e\n\n### Protanomaly Correction\n\n```bash\nbyakugan_vision --images \"tests/test_images/naruto.jpg\" --protanomaly 2\n```\n\n\u003cimg src=\"tests/test_images/filtered/Filtered_naruto_deuteranomaly_0_protanomaly_2.jpg\" style=\"width: 200px\"\u003e\n\n### Deuteranomaly and Protanomaly Correction\n\n```bash\nbyakugan_vision --images \"tests/test_images/naruto.jpg\" --deuteranomaly 2 --protanomaly 2\n```\n\n\u003cimg src=\"tests/test_images/filtered/Filtered_naruto_deuteranomaly_2_protanomaly_2.jpg\" style=\"width: 200px\"\u003e\n\n\n```bash\nbyakugan_vision --images \"tests/test_images/naruto.jpg\" --deuteranomaly 0.5 --protanomaly 0.5\n```\n\n\u003cimg src=\"tests/test_images/filtered/Filtered_naruto_deuteranomaly_0.5_protanomaly_0.5.jpg\" style=\"width: 200px\"\u003e\n\n### Filter an Image\n\n```bash\nbyakugan_vision --images \"tests/test_images/naruto.jpg\" --filter red\n```\n\n\u003cimg src=\"tests/test_images/filtered/Filtered_naruto_red.jpg\" style=\"width: 200px\"\u003e\n\n\n## Differences between images\n\nThe left image used in the example is from the following source:\nhttps://www.anime2you.de/news/606180/naruto-feiert-20-anime-jubilaeum/\n\n\u003cdiv style=\"display: flex; flex-direction: row;\"\u003e\n    \u003cimg src=\"tests/test_images/naruto.jpg\" alt=\"First Image\" style=\"width: 200px; margin-right: 5px;\"\u003e\n    \u003cimg src=\"tests/test_images/naruto_modified.jpg\" alt=\"Second Image\" style=\"width: 200px; margin-left: 5px;\"\u003e\n\u003c/div\u003e\n\n### Difference with no Filter\n\n```bash\nbyakugan_vision --diff \"tests/test_images/naruto.jpg,tests/test_images/naruto_modified.jpg\" --out_dir tests/test_images/diff\n```\n\n\u003cimg src=\"tests/test_images/diff/Diff_naruto_naruto_modified.jpg\" style=\"width: 200px\"\u003e\n\nNote: The output depends on the order of the images in the tuple. The first image is subtracted from the second image.\nThat is why the following command results in a different output:\n\n```bash\nbyakugan_vision --diff \"tests/test_images/naruto_modified.jpg,tests/test_images/naruto.jpg\" --out_dir tests/test_images/diff\n```\n\n\u003cimg src=\"tests/test_images/diff/Diff_naruto_modified_naruto.jpg\" style=\"width: 200px\"\u003e\n\n\n### Red Filtered Difference\n\n```bash\nbyakugan_vision --diff \"tests/test_images/naruto.jpg,tests/test_images/naruto_modified.jpg\" --filter red --out_dir tests/test_images/diff\n```\n\n\u003cimg src=\"tests/test_images/diff/Diff_naruto_naruto_modified_red.jpg\" style=\"width: 200px\"\u003e\n\n### Blue Filtered Difference\n\n```bash\nbyakugan_vision --diff \"tests/test_images/naruto.jpg,tests/test_images/naruto_modified.jpg\" --filter blue --out_dir tests/test_images/diff\n```\n\n\u003cimg src=\"tests/test_images/diff/Diff_naruto_naruto_modified_blue.jpg\" style=\"width: 200px\"\u003e\n\n### Green Filtered Difference\n\n```bash\nbyakugan_vision --diff \"tests/test_images/naruto.jpg,tests/test_images/naruto_modified.jpg\" --filter green --out_dir tests/test_images/diff\n```\n\n\u003cimg src=\"tests/test_images/diff/Diff_naruto_naruto_modified_green.jpg\" style=\"width: 200px\"\u003e\n\n### Yellow Filtered Difference\n\n```bash\nbyakugan_vision --diff \"tests/test_images/naruto.jpg,tests/test_images/naruto_modified.jpg\" --filter yellow --out_dir tests/test_images/diff\n```\n\n\u003cimg src=\"tests/test_images/diff/Diff_naruto_naruto_modified_yellow.jpg\" style=\"width: 200px\"\u003e\n\n## Byakugan\n\nThe [Bykugan](https://naruto.fandom.com/wiki/Byakugan) from Naruto is a powerful ability that grants users the ability \nto see through objects, detect chakra, and perceive long distances, but users are born blind, relying solely on this \nspecial vision.\n\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhokagem%2Fbyakuganvisualizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhokagem%2Fbyakuganvisualizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhokagem%2Fbyakuganvisualizer/lists"}