Skip to content
python implementation of a photo mosaic software
Branch: master
Clone or download
cinemast Merge pull request #2 from tobiasneidig/keep-ratio
Keep the ratio while cropping the images
Latest commit 33b61c5 Apr 14, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc added latex slides + images Jun 23, 2015
.gitignore Initial commit Jun 23, 2015 Keep the ratio while cropping the images Jul 30, 2016
LICENSE Initial commit Jun 23, 2015 referenced dataset Jun 23, 2015 Added possiblity to randomize the images for one 'pixel' Jul 30, 2016 added implementation Jun 23, 2015 added implementation Jun 23, 2015


This software enables the creation of photo mosaics, based on image retrieval techniques.

For feature extraction, the RGB as well as the HSV average colors in the image are retrieved and added to a index.


Python 2.x, Python OpenCV bindings, numpy

On debian based systems, you can simply type

sudo apt-get install python python-numpy python-opencv

How to run

  • Clone this repo, or download the tarball.
  • Create a directory called images
  • Put your library for the mosaic images there. An example image set can be found here
  • Run python (only first time, or on every library update)
  • Run python inputimage.jpg 20 rgb mymosaic.jpg

This creates an index over the given library and stiches a mosaic with tiles of the size 20x20 based on the inputimage.jpg.




20x20, 10x10, 5x5 tiles

input input input

You can’t perform that action at this time.