A parallelized Sudoku solver implemented with various solving algorithms in C++.

Sudoku is one of the most popular puzzle games of all time. The objective of Sudoku is to fill a n-by-n grid with digits from 1 to n such that each column, row, and box (or called "subgrid", "region", "block") contain every number in the set {1, ... , n} exactly once.

This project aims to implement a Sudoku solver that could solve large (e.g., 16-by-16, 25-by-25) Sudoku puzzles as efficiently as possible by means of various parallelization techniques and solving algorithms. The details of implementation and performance results are explained in depth in the project report.

• Compile

  1. Navigate to the project root directory where the Makefile is located.
  2. Build the program by running the command:

     $ make

  3. An executable named sudoku_main will appear in the project root directory.

• Run

  To run the solver, supply the executable with command-line arguments for test cases, modes, number of threads and flag for writing solution to a text file.

  $ ./sudoku_main <PATH_TO_INPUT_FILE> <MODE> <NUM_THREADS> [<WRITE_TO_SOLUTION_TXT>]

  ✏️ Note:

  • <PATH_TO_INPUT_FILE> (string): the path to the test case file (e.g., Test_Cases/9x9_easy.txt)
  • <MODE> (int): the mode to run the Sudoku solver
    • 0: sequential mode with backtracking algorithm
    • 1: sequential mode with brute-force algorithm
    • 2: parallel mode with brute-force algorithm
    • 3: sequential mode with DLX algorithm
    • 4: parallel mode with DLX algorithm
  • <NUM_THREADS> (int): if you set 2 or 4 for <MODE>, you need to also set <NUM_THREADS> (default = 2)
  • <WRITE_TO_SOLUTION_TXT> (int):
    • 0 (default): only print solution to the console
    • 1: also write solution to a text file called solution.txt under the project root directory

There are many different mode options available for this software. Two of them are shown as follows for demonstration purpose:

• Sequential mode for brute-force algorithm

  

• Parallel mode for brute-force algorithm

  

A collection of test grids of various sizes and difficulty levels are present in the Test_Cases directory.

Whether you use this project, have learned something from it, or just like it, please consider supporting it by buying me a coffee or making one-time donations via PayPal, so I can dedicate more time on open-source projects like this. 💪🙃

Thanks!:heart: and Cheers!:beers:

If you have any question or suggestion, feel free to contact me at [email protected]. Contributions are also welcomed. Please open a pull-request or an issue in this repository.

This project is licensed under the terms of .