A Python package for fast and robust Image Stitching
Project description
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
The command line interface (cli) is available after installation
stitch -h
show the help
stitch *
stitches all files in the actual dir
stitch img_dir/IMG*.jpg
stitches all files in the img_dir directory
starting with "IMG" and ending with ".jpg"
stitch img1.jpg img2.jpg img3.jpg
stitches the 3 explicit files of the current dir
Or use the Stitcher class in your script
import stitching
stitcher = stitching.Stitcher()
panorama = stitcher.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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for stitching-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ddfd2480c3fe8556b89618ab1f97c81305c132c5168604d1066741898417b9c3 |
|
MD5 | 817a078dd05948bd644a405acea5b422 |
|
BLAKE2b-256 | f80ff774134004bcd34c43fb3aaae69d7e7275b9fcff6f683127c13297b51e60 |