Block-Design

An image model for the block design test.

Run python main.py to get started.

Example:

python main.py --puzzle puzzle_b --face_search beeline_search --piece_search sequential_search --puzzle_memory_loss .5 --puzzle_memory_loss_counter_limit 5 --glance_factor 1 --csv stats.csv

...solves puzzle_b.png using the beeline face search and sequential puzzle piece search, with a memory loss of 50% of the puzzle every 5 puzzle piece attempts, recall of 100% of the puzzle image's width and height from some top left corner of the puzzle, and dump the solution list to stats.csv.

python main.py --analyze past_runs/puzzle_c_beeline_search_skip_unknown_search_0.1_3_1.0_1000.csv --output_file output.csv

... analyzes the designated file and outputs results to output.csv

Parameters

Solving the puzzle

--puzzle

The name of the puzzle image to solve

--face_search

The search algorithm to find the destination pattern on a block

--piece_search

The search algorithm that returns the next piece of the puzzle to solve

--puzzle_memory_loss

The rate of memory loss (0-100% of entire puzzle)

--puzzle_memory_loss_counter_limit

Memory loss kicks every time this limit of puzzle piece attempts (resets every time the limit is achieved; sometimes, we get a puzzle piece of "UNKNOWN" and this constitutes an attempt)

--glance_factor

Memory recall is will be refreshed from some top left point (row, col), extending to the bottom right point (puzzle_height * glance_factor, puzzle_width * glance_factor)

--state_image_path

If provided, saves each state of a run into number coded .pngs to this designated path

--iterations

Number of times to solve the puzzle using this configuration. Use in conjuction with the --csv flag.

--csv

Dumps the full list of solution actions to the specified file. If "default" is passed, use a name delineated by the configuration, e.g. {puzzle_input}{face_search_input}{puzzle_piece_search_input}{puzzle_memory_loss_factor_input}{puzzle_memory_loss_counter_limit_input}{glance_factor_input}{iterations_input}