Using OpenCV to solve a sudoku
A small Python script that solves sudoku from images
By Quentin GolsteynPython • December 2020
I recently acquired a pretty fun new hobby, solving sudokus. In that process, I discovered a new YouTube channel, Cracking the Cryptic, which is releasing two new sudoku puzzles every day. I have been diligently attempting these new puzzles and practicing easier puzzles on a sudoku book I have at home.
While struggling to solve another sudoku (rated as "easy" which is probably incorrect), I thought of another computer vision project: could my computer solve sudoku from a picture of one?
I want to be able to recognize the sudoku in an image, adjust for perspective, identify the numbers in the grid, and solve the sudoku. I then want to print the solution back into the image, adjusting for perspective. This article will cover the algorithm I created to process images of sudokus. It consists of the following steps:
- Find the sudoku grid in an image
- Perform a perspective warp to create a top-down view of the sudoku
- Split the sudoku image into its cells
- Identify the number in each cell (or lack thereof)
- Identify the row and column number for each cell
- Solve the sudoku
- Write the result in the original image, adjusting for perspective
This project will require OpenCV, sklearn, and numpy installed on your machine.
pip install opencv-python numpy sklearn
Let's start by importing our dependencies:
import cv2import numpy as npimport globimport os
All images are taken from one sudoku book. If you use this code on any other sudoku grid, you may need to adjust some parameters.✱I will be processing images in a folder. I process images one by one, first resizing them to a more manageable size to help with processing. The code below will form the main loop of this image processing task. I will be processing images in a folder.
Finding the sudoku grid in an image
I am looking for a large square consisting of 81 smaller squares. This square can be taken from any perspective. In other words, I am looking for a quadrilateral in an image.
Looking for quadrilaterals
I will be using OpenCV contours to find quadrilaterals. After thresholding the image (using adaptive thresholding), I can generate a list of contours present in the image. I then need to filter these contours to only those that closely resemble a quadrilateral.
OpenCV contour methods?
cv2.approxPolyDP are used to detect quadrilaterals.
cv2.arcLength returns the length of the perimeter of a contour while
cv2.approxPolyDP uses the Ramer–Douglas–Peucker algorithm, a recursive algorithm that performs a curve simplification by returning a similar curve with fewer points. Wikipedia✱
cv2.approxPolyDP returns a contour forming an approximation of the contour passed as argument. The approximation is controlled by a parameter, ϵ, which defines the maximum variance between the perimeter of the approximation and the original contour.
cv2.approxPolyDP is useful when trying to find contours that approximates a quadrilateral. If the approximate contour has four points while ϵ is kept to a low value (here 1% of the perimeter of the original contour), I know I have a quadrilateral.
To verify if I found the contour of the sudoku grid (and not the contour of a cell of the grid for example), I check that the contour contains 81 smaller quadrilaterals. If this is the case, it is very likely that I found the sudoku grid.
Basic concepts of the homography explained with code?Two images of the same planar surface are related by a homography. If we can determine the plane of the sudoku grid, we can create a new image where the grid appears directly below the camera (ie. on the image plane). This process is also known as perspective removal.
To find a homography matrix, I need to find four corresponding points shared between the two images. I already have four points from our initial image when I located the sudoku grid. The corresponding points in the perspective corrected image are the four corners of the image.
OpenCV allows us to calculate a homography matrix and apply the perspective correction to an image.
Extracting each cell in the grid
I need to extract each cell from the warped image to read their value when creating a 2D array of the sudoku grid. I apply the same methods that I used to find the sudoku grid.
Representing the sudoku grid as a 2D array
Retrieving the number in each cell
I have an image of all the 81 cells of the sudoku, corrected for perspective. Now I need to extract the number printed in each cell (if it exists). For this, I trained a k-nearest neighbours classifier on a subset of the cell images taken from the same sudoku book.
Each cell image was resized to a 28∗28 matrix and flattenned into a row of our example matrix X. I labeled each cell image with the number in the cell, or 0 if the cell was empty.
I selected k=5 for the classifier. With a dataset of 1008 sudoku cells, with a 70:30split between the training and test dataset, the model achieved 100% accuracy on the training and testing data. This high accuracy is a result of the model being trained on cells coming from the same sudoku book, leaving very little variance between each example.
Determining the row and column of each cell
I can determine which row and column each cell belongs to through a simple sort. Sorting cells by their x coordinate, the first nine cells are part of the first row, the next nine part of the second row, and so on. The same logic applies to the y values.
This logic works as I adjusted the sudoku grid for perspective in an earlier step. Hence, I assume that rows will remain roughly horizontal and columns roughly vertical.
Solving the sudoku
I used a backtracking algorithm to solve the sudoku. After retrieving a list of all empty cells of the sudoku grid, I test a number for each empty cell one by one. I first verify that the number is a valid move for this cell. If so, I use recursion to solve the sudoku given the guess I made for that initial empty cell. If no number is valid for a particular empty cell, I backtrack, testing a new value for the previous empty cell. This article provides a more thorough explanation of this process.
Backtracking algorithms are usually equivalent to brute-force methods as most don't adopt any efficient heuristics. The algorithm I used is no different. However, for this project, it proved to be a relatively simple solution to solving sudoku.
With the sudoku solved, I can then print the values of the solved grid back into the perspective corrected image. I then warp the solved sudoku image back into its original perspective using the inverse of the homography matrix found in the initial step.
You can find all the code for this small project in this Gist!