{"id":15698131,"url":"https://github.com/bryanlimy/samurai-sudoku-solver","last_synced_at":"2025-05-09T01:08:03.239Z","repository":{"id":113990897,"uuid":"53811214","full_name":"bryanlimy/samurai-sudoku-solver","owner":"bryanlimy","description":"Samurai Sudoku solver in Python","archived":false,"fork":false,"pushed_at":"2016-10-12T18:28:47.000Z","size":354,"stargazers_count":7,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-09T01:07:33.429Z","etag":null,"topics":["ai","backtracking-search","csp","puzzle","python","solver","sudoku","sudoku-solver"],"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/bryanlimy.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":"2016-03-13T22:32:16.000Z","updated_at":"2024-03-31T23:03:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"eb7bea64-88c6-4f9e-8ffb-a57f3331fa6e","html_url":"https://github.com/bryanlimy/samurai-sudoku-solver","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/bryanlimy%2Fsamurai-sudoku-solver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryanlimy%2Fsamurai-sudoku-solver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryanlimy%2Fsamurai-sudoku-solver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bryanlimy%2Fsamurai-sudoku-solver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bryanlimy","download_url":"https://codeload.github.com/bryanlimy/samurai-sudoku-solver/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253171254,"owners_count":21865292,"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":["ai","backtracking-search","csp","puzzle","python","solver","sudoku","sudoku-solver"],"created_at":"2024-10-03T19:23:29.731Z","updated_at":"2025-05-09T01:08:03.198Z","avatar_url":"https://github.com/bryanlimy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Samurai Sudoku Solver\n### Samurai Sudoku solver in Python for CSC384H Final Project\n\n## How To Run The Code\n```\n\u003e python3 samurai.py\nInsert file path containing the Samurai Sudoku:\n\u003e \u003cfile path to Samurai Sudoku. i.e. tests/easy1.txt\u003e\n```\n\n## Description\n\n### [samurai.py](./samurai.py)\nThis is our solver, when running this program as __main__ it solves any user fed samurai sudoku puzzle given in the format exampled by the files in our tests/ folder.\n\nOnce the program runs, you will be prompted to give a path to a Samurai Sudoku puzzle. We have 8 hand-made puzzles available to you in the tests/ folder. An example input is:\n```\n./tests/easy1.txt\n```\n\n### [analyse.py](./analyse.py)\nThis program is used to analyse our solvers solution to randomly generated Samurai Sudoku puzzles. It is currently set to analyse only 100 different puzzles. However, in our testing we usually run it on 1,000 to 10,000 test cases. The program will output 5 csv files containing data on counts of which squares were initially assigned values in solved Samurai Sudoku puzzles.\n```\n\u003e python3 analyse.py\n```\n\n### [imaging.py](./imaging.py)\nThis program is used to create the hash-maps seen in the project report and in the heatmaps/ folder. This program works by feeding it a path to a specifically formatted .csv file, the program then generates a heatmap from that file and outputs to screen.\n*Note: Unfortunately, the heatmap library used is incompatible with CDF computers and require external libraries to use. Since the point of the program is just to generate heatmaps for data visualization for the report it shouldn't be considered a main feature of our assignment. You could instead find all the same conclusions from the data in the .csv files available in the data/ folder. This program just provides a nice visualization of that data.\n```\n\u003e python imaging.py PATH_TO_CSV_FILE (must be python 2.7X)\n```\n\n## Note\nThe solver works on both `python` and `python3`; however, we suggest using running in `python3`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbryanlimy%2Fsamurai-sudoku-solver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbryanlimy%2Fsamurai-sudoku-solver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbryanlimy%2Fsamurai-sudoku-solver/lists"}