kupiakos / image-stitcher

A panoramic image stitching tool made with OpenCV and Python

image-stitcher

An panoramic image stitching tool made with OpenCV and Python. It supports arbitrarily large numbers of files, automatically detects centered images, has good configuration options, and basic color correction! Transparency in images is also supported by default.

Example

Say we have these three images in the demo directory.

We can use the following command to combine the three into one image, performing color correction and giving basic log output.

./stitcher.py demo/squaw_peak?_600.jpg -vco demo/squaw_peak_merged_600.png

That results in this image:

Neat, huh? For extra documentation, run ./stitcher.py --help, or just read the source.

Installation

NumPy, SciPy, Matplotlib, and OpenCV all need to be installed to Python 3.

Most importantly, this script requires an OpenCV build with SIFT support. I might implement ORB support at sometime in the future. Since SIFT's not installed by default (as it's nonfree), you'll probably have to compile OpenCV on your own. I highly recommend this tutorial on building OpenCV with full support for everything. Just modify it a bit for OpenCV 3.2.

Bugs

Probably.