modeler

A Python package to reconstruct 3D models from video

https://github.com/ItsWajdy/modeler

Science Score: 10.0%

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

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: researchgate.net
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (9.2%) to scientific vocabulary

Keywords

3d-reconstruction computer-vision opencv opencv-python python python3 sfm structure-from-motion
Last synced: 6 months ago · JSON representation

Repository

A Python package to reconstruct 3D models from video

Basic Info
  • Host: GitHub
  • Owner: ItsWajdy
  • License: mit
  • Language: Python
  • Default Branch: master
  • Homepage:
  • Size: 29.3 KB
Statistics
  • Stars: 52
  • Watchers: 2
  • Forks: 17
  • Open Issues: 1
  • Releases: 0
Archived
Topics
3d-reconstruction computer-vision opencv opencv-python python python3 sfm structure-from-motion
Created about 7 years ago · Last pushed about 7 years ago
Metadata Files
Readme License

README.md

modeler

A simple package to reconstruct a 3D model of an object from a video taken for that object

Prerequisites

This package uses Python 3.x

Also, you'll need OpenCV and numpy which can be downloaded using the following commands pip install numpy pip install opencv-python

Installation

To install modeler simply run this command from the command line: pip install modeler Or pip install git+git://github.com/Wajdy759/modeler.git#egg=modeler Then you can import it using: import modeler

Usage

modeler has a module called SfM which handles wraps everything you'll need sfm = SfM(results_dir, video_already_converted, video_path, video_sampling_rate) Where: - results_dir: the directory where the module outputs the .ply file - video_already_converted: a boolean set to true if the video used was already converted to images in 'inputimages' - `videopath: in case video_already_converted is False, the module uses the video in 'video_path' as input -videosamplingrate`: the frequency at which the module extracts images from the video to use in the actual reconstruction

To actually run the algorithm and get the 3D model you'd use sfm.find_structure_from_motion()

Example

``` from modeler import SfM

sfm = SfM('results/', False, 'videos/vid1.mp4', 27) sfm.structurefrommotion() ``` When the progrm terminates you'll get a set of .ply files in the folder named results

References

This project was heavily inspired by this article https://www.researchgate.net/publication/2651908803Dreconstructionfrommultiple_images

Owner

  • Name: Wajdy
  • Login: ItsWajdy
  • Kind: user

Artificial Intelligence Engineer

GitHub Events

Total
  • Watch event: 4
  • Fork event: 2
Last Year
  • Watch event: 4
  • Fork event: 2

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 7
  • Total Committers: 1
  • Avg Commits per committer: 7.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
Wajdy w****0@g****m 7

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 1
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 1
  • Total pull request authors: 0
  • Average comments per issue: 2.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
  • 1chimaruGin (1)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels