photomosaic
===========

[![Build Status](https://travis-ci.org/danielballan/photomosaic.svg)](https://travis-ci.org/danielballan/photomosaic)

Assemble thumbnail-sized images from a large collection into a mosaic which,
viewed at a distance, gives the impression of one large photo.

Example
-------

```python
import photomosaic as pm

# Load a sample image
from skimage import data
img = data.chelsea()  # cat picture!

# Generate dummy images covering the color gamut to use as a pool.
pm.generate_tile_pool('pool')

# Build the pool (analyze the dummy images).
pool = pm.make_pool('pool/*.png')

# Create a mosiac with 15x15 tiles.
mos = pm.basic_mosaic(img, pool, (15, 15))

# (Optional) Plot the mosaic using matplotlib.
import matplotlib.pyplot as plt
plt.imshow(mos)

# Save it.
from skimage import imsave
imsave(mos, 'mosaic.png')
```

Related Project
---------------
[John Louis Del Rosario](https://github.com/john2x) also has a
[photomosaic project](https://github.com/john2x/photomosaic) in Python. I
studied his code while I began writing version 0.1.0 of this project in 2012,
and there were similarities. Version 0.2.0 (2016) is a complete rewrite that
takes a fundamentally different approach.

photomosaic
===========

[![Build Status](https://travis-ci.org/danielballan/photomosaic.svg)](https://travis-ci.org/danielballan/photomosaic)

Assemble thumbnail-sized images from a large collection into a mosaic which,
viewed at a distance, gives the impression of one large photo.

Documentation: [http://danielballan.github.io/photomosaic/docs/](http://danielballan.github.io/photomosaic/docs/)

Related Work
------------
[John Louis Del Rosario](https://github.com/john2x) also has a
[photomosaic project](https://github.com/john2x/photomosaic) in Python. I
studied his code while I began writing version 0.1.0 of this project in 2012,
and there were similarities. Version 0.2.0 (2016) is a complete rewrite that
takes a fundamentally different approach.

Replace example in readme with link to docs.
DOC: Replace example in readme with link to docs.
