Caching Strategies for Image Processing

This repository contains the source code used for the bachelor thesis Caching Strategies for Image Processing. A number of algorithms that are interesting in a caching context have been implemented and their cache performance has been tested/compared on three different data structures.

Algorithms

Recursive Matrix Multiplication
Spatial Convolution
Fast Marching Method
Iterative Fast Fourier Transform

Data Structures

Morton ordering
Block array
Standard row major array

If you want to learn more about these, you are welcome to read the thesis where they have been described in depth.

Running the code

The code uses pycachesim for simulating the cache, so to be able to run the code you will need to:

$ pip install pycachesim

The tests of performance itself and plots of the results are defined in the different .ipynb-files in the src-directory. As the performance tests can take quite a long time to run (8+ hours on a modern computer), the results have been saved in JSON format to the src/results/-folder.

When viewing the Notebooks, you can either simply glance over the already plotted results, load in the generated JSON and play with the data or, if you wish to generate the results anew, change the following line which is in the top of all the Notebooks:

# Set to true if you want to run the tests again. Otherwise just loads results from JSON
GENERATE_NEW_RESULTS = False

Testing correctness

To test that the algorithms and data structures work as intended, a number of correctness tests have been defined in the src/tests/-folder. Run $ pytest to execute these.

Credits