stitching

A Python package for fast and robust Image Stitching. A modularized and continuing work based on opencv's stitching module and the stitching_detailed.py python command line tool.

Installation

Use pip to install stitching from PyPI.

pip install stitching

Usage

import stitching

stitcher = stitching.Stitcher()
panorama = stitcher.stitch(["img1.jpg", "img2.jpg", "img3.jpg"])

or using the command line interface (cli) which is available after installation

stitch -h
stitch img1.jpg img2.jpg img3.jpg

Tutorial

This package provides utility functions to deeply analyse what's happening behind the stitching. A tutorial was created as Jupyter Notebook. The preview is here.

You can e.g. visualize the RANSAC matches between the images or the seam lines where the images are blended:

Literature

This package was developed and used for our paper Automatic stitching of fragmented construction plans of hydraulic structures

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Run tests using

python -m unittest

Build with

python -m build

Please make sure to lint all pull requests.

Lint the changed files

pre-commit install && pre-commit run

License

Apache License 2.0