{"id":17526821,"url":"https://github.com/shaunhwq/visual_comparison","last_synced_at":"2025-03-06T06:30:52.777Z","repository":{"id":144124857,"uuid":"574495401","full_name":"shaunhwq/visual_comparison","owner":"shaunhwq","description":"A comparison tool to aid image/video enhancement research","archived":false,"fork":false,"pushed_at":"2024-08-12T17:03:55.000Z","size":33131,"stargazers_count":21,"open_issues_count":17,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-12T19:50:37.309Z","etag":null,"topics":["computer-vision","image-comparison","image-denoising","image-enhancement","low-light-image-enhancement","super-resolution","video-comparison","video-denoising","video-enhancement","video-super-resolution"],"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/shaunhwq.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":"2022-12-05T12:47:17.000Z","updated_at":"2024-08-12T17:02:18.000Z","dependencies_parsed_at":"2023-05-18T21:31:09.163Z","dependency_job_id":"2a13eeab-2b2d-4f4a-9193-d897e704c436","html_url":"https://github.com/shaunhwq/visual_comparison","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaunhwq%2Fvisual_comparison","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaunhwq%2Fvisual_comparison/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaunhwq%2Fvisual_comparison/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shaunhwq%2Fvisual_comparison/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shaunhwq","download_url":"https://codeload.github.com/shaunhwq/visual_comparison/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242161378,"owners_count":20081859,"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":["computer-vision","image-comparison","image-denoising","image-enhancement","low-light-image-enhancement","super-resolution","video-comparison","video-denoising","video-enhancement","video-super-resolution"],"created_at":"2024-10-20T15:02:32.858Z","updated_at":"2025-03-06T06:30:52.769Z","avatar_url":"https://github.com/shaunhwq.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Visual Comparison\n\n## Introduction\nA tool for comparing images \u0026 videos, to aid research in image/video enhancement.\n\n- Removes need to generate comparison images\n- Quickly switch between files and methods using keybindings or buttons\n- 3 different comparison modes for more effective comparison\n- Preview and filter window to quickly search, filter and skip to desired images\n- Zoom to see fine details or enhancement\n- Video exporting functionality to share comparison videos\n\nSimply generate your enhanced images/videos, store it together with outputs from other methods and source images. Then,\nrun the application, and select the root folder and preview folder using the GUI.\n\n## Problem\n\nAble to spot the differences?\n\n![](documentation_images/hard_comparison.jpg)\n\nHow about now?\n![]()\n\n| Compare (Up to 4) | Show Specific | Concat |\n| --- | --- | --- |\n| ![](documentation_images/compare.gif) | ![](documentation_images/specific.gif) | ![](documentation_images/concat.jpg) |\n| Shows up to 4 files at once. Move mouse accordingly | Shows a single method based on what the user selected (with their keyboard) | Display all files horizontally. Still useful for images with large differences |\n\nInterested in looking at small regions of the image?\n\n| Zoom (Compare) | Zoom (Specific) | Zoom (Concat) |\n| --- | --- | --- |\n| ![](documentation_images/zoom_compare.gif) | ![](documentation_images/zoom_specific.gif) | ![](documentation_images/zoom_concat.jpg) |\n\nMany files or methods to compare?\n\n| Mouse/Keyboard Control | Button Control | File filtering |\n| --- | --- | --- |\n| ![](documentation_images/navigation_ad_scroller.gif) | ![](documentation_images/idx_method_buttons.gif) | ![](documentation_images/filtering.gif) |\n| Navigate files using 'a', 'd' or arrow keys. Scroll to preview other files | Select which method to compare and jump to specific index | Filter/sort files by name, height, width, etc. |\n\n## Usage\n\n### \u003cu\u003e Installation \u003c/u\u003e\n\nCreate a virtual environment with Python 3.8.10 Then,\n\n```\npip3 install -r requirements.txt\n```\n\nNext, install the necessary package for the copy image to clipboard feature\n```\n# MacOS - None\n\n# Windows\npip3 install pywin32\n\n# Linux\npip3 install klembord\n```\n\n\n### \u003cu\u003e Folder Structure \u003c/u\u003e\n\nYour files should be stored in the following manner:\n\n```\nroot\n├── file1.jpg  # Files will be excluded\n├── method_1  # Could be name of algorithm or outputs from epoch\n    ├── file1\n    ├── file2\n    └── ...\n├── method_2\n    ├── file1\n    ├── file2\n    └── ...\n└── source  # source folder (used for preview). Can be specified in run.py\n    ├── file1\n    ├── file2\n    └── ...\n```\n\nRequirements\n- Minimum of 2 folders since this is a comparison tool.\n- Each folder contains enhanced images from a single method.\n- Each file must have the same name as the source file.\n- Files which have the same name across \u003cb\u003e\u003cu\u003eALL\u003c/u\u003e\u003c/b\u003e subdirectories will be retrieved.\n- Images \u0026 videos should all have the same size (since we need to overlay/crop and join them)\n- Files in root folder will be excluded\n\n### \u003cu\u003e Running the program \u003c/u\u003e\n```\nusage: run.py [-h] [--root ROOT] [--preview_folder PREVIEW_FOLDER]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --root ROOT           Path to root directory\n  --preview_folder PREVIEW_FOLDER\n                        Folder to preview\n```\n\n## More Info\n\nFor more information and instructions on how to use the application, refer to the [Wiki](https://github.com/shaunhwq/visual_comparison/wiki)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshaunhwq%2Fvisual_comparison","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshaunhwq%2Fvisual_comparison","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshaunhwq%2Fvisual_comparison/lists"}