PyKlotski puzzle

This project is my assignment for artificial intelligence classes.

Klotski file format

Klotski file format is defined as follows:

• First line determines height and width of the table
• Follows height lines of following format:
  • - represents a wall
  • + represents a goal space
  • . represents a free space
  • any other symbol (including white spaces) represents a block
  • final line contains a single symbol which determines which block is the one that is supposed to be placed to goal space

Structure

Klotski

Files klotski.py and event.py contain data structures used dedicated for evaluation and manipulation with klotski tables.

Event

• This class I found while researching event system in python
• Original poster is longpoke
• It extends list with event handler capabilities

KlotskiBlock

• Contained in klotski.py
• Contains methods for block's manipulation such as:
  • by_one_movements(self) (movements by one square)
  • all_movements(self) (all possible movements of the block on table)
• Is represented by unique index
• Contains several properties among which are table (KlotskiTable), shape (set of positions determining the shape of the block) and available_movements (set of positions where can be the block placed to)

KlotskiTable

• Contained in klotski.py
• Represents table of klotski blocks
• Loads from a klotski file
• Is indexable with int (returns a row of block indeces) or a tuple of ints (returns a block index)
• Contains methods:
  • get_block(self, index) (returns a block with given index)
  • is_solved(self) (checks whether the puzzle is solved)
  • move_block(self, block, position) (moves the given block to the given position if possible, throws Exception otherwise)
• Contains two event handlers - on_solved and on_block_moved

KlotskiSimulator

The file klotski_simulator.py loads puzzles from puzzles/ folder in the root of the project and executes several runs of each agent on it. Each agent has only specified amount of time to finish each puzzle. Results of simulated race are printed to the console.

If redirected to a file, process_results.py can aggregate the information into more readable results.

Klotski Simulator's AI format

TBD

AIs

PriorityQueueAStar (PQA*)

TBD

RecursiveIDAStarCopy (CIDA*)

TBD

RecursiveIDAStarBacktrack (BIDA*)

TBD

RecursiveBFS (RBFS)

TBD

SMAstar (SMA*)

TBD

Comparison

Results are averaged from 20 runs where all agents had 3 minutes for the search.

Hardware

Operating system Manjaro Linux

CPU Intel(R) Celeron(R) CPU B840 @ 1.90GHz 1 physical processor; 2 cores; 2 threads

RAM 3967192 KiB

Motherboard A0001C02 / 161D (Hewlett-Packard)

Results

Success Rate (%)	Random	CIDA*	PQA*	BIDA*	RBFS	SMA*
sample01	100.0	100.0	100.0	100.0	TBD	TBD
sample02	100.0	100.0	100.0	100.0	TBD	TBD
sample03	100.0	100.0	100.0	100.0	TBD	TBD
sample04	100.0	100.0	100.0	100.0	TBD	TBD
sample05	0.0	0.0	0.0	0.0	TBD	TBD
sample06	100.0	0.0	0.0	0.0	TBD	TBD
sample07	75.0	0.0	0.0	0.0	TBD	TBD

Steps Needed (#)	Random	CIDA*	PQA*	BIDA*	RBFS	SMA*
sample01	1	1	1	1	TBD	TBD
sample02	10	1	1	1	TBD	TBD
sample03	215	9	9	9	TBD	TBD
sample04	76	1	1	1	TBD	TBD
sample05	0	0	0	0	TBD	TBD
sample06	833	0	0	0	TBD	TBD
sample07	251734	0	0	0	TBD	TBD

States visited (#)	Random	CIDA*	PQA*	BIDA*	RBFS	SMA*
sample01	1	2	2	2	TBD	TBD
sample02	10	2	2	9	TBD	TBD
sample03	215	4092	37	1831	TBD	TBD
sample04	76	2	2	19	TBD	TBD
sample05	654144	24238	12	275416	TBD	TBD
sample06	833	129481	334	145399	TBD	TBD
sample07	251734	109907	1566	179654	TBD	TBD

Time needed (s)	Random	CIDA*	PQA*	BIDA*	RBFS	SMA*
sample01	0.0	0.0	0.0	0.0	TBD	TBD
sample02	0.0	0.0	0.0	0.0	TBD	TBD
sample03	0.0	4.0	0.0	1.0	TBD	TBD
sample04	0.0	0.0	0.0	0.0	TBD	TBD
sample05	180.0	60.0	0.0	180.0	TBD	TBD
sample06	0.0	180.0	180.0	180.0	TBD	TBD
sample07	108.0	180.0	180.0	180.0	TBD	TBD

CPU Used (%)	Random	CIDA*	PQA*	BIDA*	RBFS	SMA*
sample01	33.0	18.0	16.0	29.0	TBD	TBD
sample02	34.0	26.0	11.0	33.0	TBD	TBD
sample03	50.0	61.0	52.0	53.0	TBD	TBD
sample04	45.0	13.0	48.0	18.0	TBD	TBD
sample05	74.0	70.0	18.0	78.0	TBD	TBD
sample06	52.0	77.0	69.0	76.0	TBD	TBD
sample07	68.0	71.0	71.0	73.0	TBD	TBD

Memory Used (%)	Random	CIDA*	PQA*	BIDA*	RBFS	SMA*
sample01	30.0	29.0	29.0	29.0	TBD	TBD
sample02	36.0	29.0	29.0	29.0	TBD	TBD
sample03	30.0	29.0	29.0	29.0	TBD	TBD
sample04	36.0	29.0	29.0	29.0	TBD	TBD
sample05	36.0	29.0	29.0	29.0	TBD	TBD
sample06	36.0	29.0	29.0	29.0	TBD	TBD
sample07	30.0	29.0	29.0	29.0	TBD	TBD

INFO: Memory is only orientational due to caching and garbage collector