https://github.com/ccomkhj/panorama_video

Panoramic image from a video file

https://github.com/ccomkhj/panorama_video

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.1%) to scientific vocabulary
Last synced: 9 months ago · JSON representation

Repository

Panoramic image from a video file

Basic Info
  • Host: GitHub
  • Owner: ccomkhj
  • Language: Python
  • Default Branch: main
  • Size: 2.93 KB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created over 2 years ago · Last pushed over 2 years ago
Metadata Files
Readme

readme.md

Panorama Creator for Videos

panorama.py is a Python script that constructs a panoramic image from a video file. It focus on the video taken with the horizontal movement.

Dependencies

  • Python 3.x
  • OpenCV (cv2)
  • NumPy
  • tqdm

Installation of Dependencies

You can install the required dependencies with the assistance of pip:

bash pip install opencv-python numpy tqdm

Usage

Run the panorama.py script in your terminal specifying the input video path, and, if desired, an output filename for the panorama:

bash python panorama.py <path_to_input_video> [-o <desired_output_panorama_path>]

Parameters:

  • <path_to_input_video>: The path to the video file from which you want to create the panorama. This is a mandatory parameter.
  • -o <desired_output_panorama_path>: The path and filename for the panorama image to be saved. This is optional. If not specified, the output will be saved as 'output_panorama.jpg' in the current working directory.

Example

Below is an example of how to run the script with the input video path as mandatory and the output panorama path as optional:

bash python panorama.py myvideo.MOV -o mypanorama.jpg

If you choose not to provide an output panorama path, the script will save the panoramic image as output_panorama.jpg by default:

bash python panorama.py myvideo.MOV

Features

  • Robust feature detection and matching using ORB (Oriented FAST and Rotated BRIEF) algorithm.
  • Image warping and stitching for seamless panorama construction.
  • Customizable sliding window width to handle varying degrees of overlap between frames.
  • Automatic handling of termination signals; the script saves the current state of the panorama if interrupted.

Safety and Cleanup

The script registers signal handlers to ensure that the current progress is not lost even if the process gets an interrupt (CTRL+C) or termination signal. A partially completed panorama is saved automatically in response to these signals.

Considerations

The current implementation assumes that the camera is mostly stationary with primarily horizontal movement. Significant variations in camera position or vertical movement may affect the quality of the resulting panorama.

Contributions and License

This project is open for contributions. Feel free to fork, modify, and suggest enhancements or fixes through pull requests. The project is provided as-is with no warranty, and use of the code is under your own discretion.

Happy panoramic image capturing!

Owner

  • Name: Huijo
  • Login: ccomkhj
  • Kind: user
  • Location: Germany
  • Company: @hexafarms

Self Learner

GitHub Events

Total
Last Year

Committers

Last synced: 11 months ago

All Time
  • Total Commits: 2
  • Total Committers: 1
  • Avg Commits per committer: 2.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
ccomkhj c****j 2

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 0
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels