Skip to main content

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.

inputs

result

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 tool

python stitching_tool.py -h
python stitching_tool.py 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:

matches1 matches2 seams1 seams2

Literature

This package was developed and used for our paper 'Automatic stitching of fragmented construction plans of hydraulic structures' https://doi.org/10.1002/bate.202200010

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

License

Apache License 2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stitching-0.1.0.tar.gz (18.5 kB view hashes)

Uploaded Source

Built Distribution

stitching-0.1.0-py3-none-any.whl (22.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page