diff --git a/.gitignore b/.gitignore
index 070faed..dbfcdbe 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,4 +2,5 @@ dataset
 descriptors
 *~
 *#
-coursework.pdf
+*.pdf
+!report.pdf
diff --git a/README.txt b/README.md
similarity index 59%
rename from README.txt
rename to README.md
index d12a366..4478996 100644
--- a/README.txt
+++ b/README.md
@@ -1,3 +1,16 @@
+Visual Search Coursework
+=======================
+
+Investigation into different methods of visual search including colour histograms, spatial colour, spatial texture and a combination of the two using MATLAB and the MSRCv2 dataset.
+A copy of the report can be seen [here](report.pdf). Submitted as part of the third year EE3032 Computer Vision & Pattern Recognition module, this piece achieved full marks.
+
+![Mean average precision comparisons for different distance measures](data/MAPComparison.png)
+
+![Spatial colour mean average precision for different grid dimensions](data/spatialColour/mapSurface2.png)
+
+![Detected edges in one of the dataset images](data/edgeThresholds/cow-t-0.08.png)
+
+## Code
 
 /data - pulled images and spreadsheet of data
 /descriptor - functions for extracting descriptors
diff --git a/report.pdf b/report.pdf
new file mode 100644
index 0000000..3a832e4
Binary files /dev/null and b/report.pdf differ