Coder Social home page Coder Social logo

biqar / puzzle-solver Goto Github PK

View Code? Open in Web Editor NEW
15.0 3.0 3.0 3.25 MB

This repository contains generic platform for solving and benchmarking computational puzzles using different search strategies

License: MIT License

C++ 92.91% Makefile 0.44% Shell 5.36% Python 1.29%
puzzle-solver puzzle-game problem-solving-techniques 8-puzzle-solver 8-queens-problem 8-puzzle n-queen n-queens-problem heuristic-functions search-strategies

puzzle-solver's Introduction

Puzzle Solver (by using problem solving techniques)
Language License Visitors

Solved Puzzles

Give a Star! ⭐

If you like this project please consider giving it a ⭐ star ⭐. Thanks!

Project Goal

The goal of this project is to build a generic interactive pluggable application for solving puzzles (i.e. 8-puzzle, 15-puzzle, n-queens, Sudoku, graph-coloring etc.) using different problem-solving techniques (i.e. informed search, uninformed search, hill-climbing search etc.). Here by word pluggable we mean in solving puzzles user can independently decide the search strategy along with the custom heuristic functions. If needed, user can extend this project to device their own solution with a very low effort. Besides, this application is designed in a way that, it will be an easy-going platform for benchmarking any puzzles w.r.t. different state space search strategy, optimization techniques and heuristic functions.

Project Structure

The project has several independent parts that we combine to work as a whole. Directory "core" contains two factory methods that produce the puzzle solver and heuristic instance based on the parameter passed. Puzzle solutions can be implemented in separate directory as we have done for 8-puzzle, n-queens, and k-coloring here. Heuristic implementations placed in the heuristic sub-directory under the corresponding puzzle. Directory "utils" all the utility methods that help other functions to operate.

Please keep in mind, this is an active project and project architecture may change without any prior announcement. But all the future updates will be maintained in a way so that the project integrity will ke kept, meaning you will not face any difficulty in building or running the project.

How to Build

# go to project directory
$ cd puzzle-solver

# build the project
$ make clean && make

How to Run

General run command:

./puzzle -problem {PUZZLE_NAME} \
-algo {ALGORITHM_NAME} -mode {MODE} \
-heu {HEURISTIC_METHOD} \
-initial {INITIAL_STATE_OF_THE_GAME} -goal {GOAL_STATE_OF_THE_GAME} \
-board_dim {DIMENSION_OF_THE_BOARD} -mx_sideways_move {MAX_SIDEWAYS_MOVE}\
-print_path {PRINT_INITIAL_TO_GOAL}

Here is the parameter definition,

  1. -problem: Specify the puzzle name to solve, for example, 8-puzzle.
  2. -algo: Specify the search strategy to solve the puzzle, for example, "A*", "bfs", "dfs", etc.
  3. -mode: Specify the inner methodology for the search strategy, for example, "bi-directional" bfs, "stack-based" dfs, etc.
  4. -heuristic: Specify the heuristic function you want to use, for example, "hamming", "manhattan", "euclidean", etc. [default: manhattan]
  5. -initial: Specify the initial board setup for your puzzle
  6. -goal: Specify the goal state of your puzzle
  7. -board_dim: Board dimension, may use representing any square board
  8. -mx_sideways_move: Maximum allowed sideways move in hill-climbing search
  9. -print_path: Flag to indicate printing path if solution exist, accepts boolean string, i.e., "true" or "false".
  10. -file: Input file containing large input data. For example, we keep the constraint graph needed by k-coloring algorithm.
  11. -mcolor: Maximum allowed color, value -1 means we need to find the chromatic number, value (>0) means we need to color the graph by using this number of colors.
  12. -mrv: Flag to indicate whether we will apply heuristic Minimum Remaining Values (MRV) for selecting the next vertex to color.
  13. -degree_heu: Flag to indicate whether we will apply heuristic Minimum Remaining Values (MRV) for selecting the next vertex to color.
  14. -lcv: Flag to indicate whether we will apply heuristic Minimum Remaining Values (MRV) for selecting the next vertex to color.

Motivation of Algorithm Mode

While implementing different algorithms for solving 8-puzzle problem, we found some optimization techniques help the algorithms' to be more efficient. These techniques can be rigid or independent w.r.t. the algorithm itself. For example, bi-directional search technique is very common in the domain of searching algorithms and can be applied to a large number of algorithms. Bi-directional search launch two searches, one from the initial state to the goal state and another one from the reverse direction. The key benefit here is it help reduce the search space, as we know the search trees grow exponentially by their depth. From table 1, we can find that the bi-directional strategy generates at least 2x less nodes comparing to the original algorithms (i.e. Optimized BFS vs. Bi-directional BFS). Fig 1 give a brief idea about the state space reduction by bi-directional strategy while applied in BFS. We can also observe in some cases within some constraints the original algorithm fails to reach the goal, whereas applying bi-directional approach may help reaching the goal (i.e. DLS vs. Bi-directional DLS for input 5). This become possible due to the lower search space generated by bi-directional approaches.

state_space_landscape
Figure 1: Showing search space reduction by bi-directional search

Some techniques can be applied to very selective algorithms. For example, DFS is a very well known algorithm in the domain of state space search and can be implemented in recursive and non-recursive (stack based) way. The benefit of using stack based DFS is avoiding stack overflow due to excessively deep recursions.

Heuristics Vs. Metaheuristics

H.E. Lehtihet's reply in [3]

Heuristics are problem-dependent techniques. As such, they usually are adapted to the problem at 
hand and they try to take full advantage of the particularities of this problem. However, because 
they are often too greedy, they usually get trapped in a local optimum and thus fail, in general, 
to obtain the global optimum solution.

Meta-heuristics, on the other hand, are problem-independent techniques. As such, they do not take 
advantage of any specificity of the problem and, therefore, can be used as black boxes. In general, 
they are not greedy. In fact, they may even accept a temporary deterioration of the solution (see 
for example, the simulated-annealing technique), which allows them to explore more thoroughly the 
solution space and thus to get a hopefully better solution (that sometimes will coincide with the 
global optimum). Please note that although a meta-heuristic is a problem-independent technique, 
it is nonetheless necessary to do some fine-tuning of its intrinsic parameters in order to adapt 
the technique to the problem at hand.

You might want to take a look also at the so-called hyper-heuristics that go a step beyond 
meta-heuristics. The particularity of hyper-heuristics is that their search space is not the 
usual space of the solutions but is rather the space of heuristics or meta-heuristics. Indeed, 
hyper-heuristics can be viewed as "heuristics to search for heuristics". There is also a slightly 
different category defined as "heuristics to generate heuristics".

Future Work

Resources

  1. [Blog] Problem Solving Techniques part1: https://mhesham.wordpress.com/2010/04/08/problem-solving-techniques-part1/
  2. [Blog] Problem Solving Techniques part2: https://mhesham.wordpress.com/tag/depth-limited-search/
  3. [ResearchGate] What are the differences between heuristics and metaheuristics? https://www.researchgate.net/post/What_are_the_differences_between_heuristics_and_metaheuristics
  4. [Paper] A Comparison between Heuristic and Meta- Heuristic Methods for Solving the Multiple Traveling Salesman Problem: https://publications.waset.org/4699/a-comparison-between-heuristic-and-meta-heuristic-methods-for-solving-the-multiple-traveling-salesman-problem
  5. [Online Book] Clever Algorithms: Nature-Inspired Programming Recipes: www.cleveralgorithms.com/nature-inspired/index.html

puzzle-solver's People

Contributors

biqar avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.