Thermometers puzzle

This assignment consists in solving the thermometers puzzle (try here an online game) described as follows. We have a grid of n x n cells that is initially filled with empty "thermometers". Each thermometer is an horizontal or vertical line (of size >1) with a "bulb" in one of its ends. The puzzle consists in filling the thermometers with mercury, always starting from their bulb towards their opposite end. Some thermometers can be left partially filled or even empty. The main constraint in the puzzle is that the number of cells filled with mercury in each row and each column must coincide with the respective numbers shown outside the grid.

The following images show an example of initial configuration of a puzzle (4 x 4) and the final solution.

Initial configuration	Solved puzzle

Step 1. Each input instance is an ASCII file containing a squared grid (n x n) with the following format. The file contains n lines (the rows) and each line contains n characters (the columns) ended by a newline. Each cell contains a character that can be:

•  '^' 'v' '>' '<' = is a thermometer bulb whose output is oriented up, down, right or left, respectively
• '|' = is a non-bulb portion of a vertical thermometer bar
  
• '-' = is a non-bulb portion of a horizontal thermometer bar

The last two lines contain the numbers associated to columns (first line) and rows (second line) separated by blank spaces.

The following shows the input format for the initial configuration above:

|>-- ^>-v vvv| |||| 3 2 1 1 1 3 2 1

The file examples.zip (To Be Added) will contain several input files and their solutions.

Step 2. Write a python program encode.py to transform each input ASCII file into a logic program containing facts. For instance:

python3 encode.py dom01.txt domain.lp

will transform the example above into the set of facts for the predicates you decide to use for representing the problem. The file domain.lp can only contain facts and constant definitions, but no conditional rules or constraints.

Step 3. Encode the tents problem in clingo in a file called thermo.lp. You can use

clingo 0 thermo.lp domain.lp

to obtain all the answer sets. You should check that each puzzle should have a unique solution. You can use the following file decode.py (to be added) that allows printing the solution as an output text file:

python3 decode.py thermo.lp domain.lp

To use this program, you need output facts like fill(X,Y) to represent that the cell at X, Y is filled with mercury. You also need a predicate dim(N) to specify the size of the grid -- in the example above, dim(4). The result produced by this program will have the form

.x.. xx.x x.x. x...

Where 'x' represents a filled cell.

Finally, if you have installed the python library pygame, you can also draw a graphical representation using the files display.py, drawthermo.lp and pics.zip (to be added) as follows. First, unzip de pictures file:

unzip pics.zip python3 display.py thermo.lp domain.lp drawthermo.lp

Assessment & delivery