Data

Tools

Indexes

Applications

Experiments

Open Source Science

pandora

A stereo matching framework that will help you design your stereo matching pipeline with state of the art performances.

https://github.com/cnes/pandora

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 (15.0%) to scientific vocabulary

Keywords

stereo-matching stereo-vision

Keywords from Contributors

photogrammetry
Last synced: 10 months ago · JSON representation

Repository

A stereo matching framework that will help you design your stereo matching pipeline with state of the art performances.

Basic Info
Statistics
  • Stars: 81
  • Watchers: 12
  • Forks: 16
  • Open Issues: 0
  • Releases: 0
Topics
stereo-matching stereo-vision
Created about 6 years ago · Last pushed 11 months ago
Metadata Files
Readme Changelog Contributing License Authors Notice

README.md

Pandora

Pandora, a stereo matching framework

[![Python](https://img.shields.io/badge/python-v3.8+-blue.svg)](https://www.python.org/downloads/release/python-390/) [![Contributions welcome](https://img.shields.io/badge/contributions-welcome-orange.svg)](CONTRIBUTING.md) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0/) [![Documentation](https://readthedocs.org/projects/pandora/badge/?version=latest)](https://pandora.readthedocs.io/) [![Github Action](https://github.com/CNES/Pandora/actions/workflows/pandora_ci.yml/badge.svg?branch=master)](https://github.com/CNES/Pandora/actions) [![Codecov](https://codecov.io/gh/CNES/Pandora/branch/master/graph/badge.svg?token=IENWO02GB3)](https://codecov.io/gh/CNES/Pandora) [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/CNES/Pandora/master)

Overview • Install • Quick Start • Documentation • Credits • Related • References

Overview

From stereo rectified images to disparity map | Pandora is working with cost volumes :-------------------------:|:-------------------------: |

Pandora is a stereo matching flexible framework made for research and production with state of the art performances:

  • Inspired from the (Scharstein et al., 2002) modular taxonomy, it allows one to emulate, analyse and hopefully improve state of the art stereo algorithms with a few lines of code.
  • For production purpose, Pandora have been created for the CNES & Airbus CO3D project processing chain, as CARS core stereo matching tool.

The tool is open for contributions, contact us to pandora AT cnes.fr !

Install

Pandora is available on Pypi and can be installed by:

bash pip install pandora

For stereo reconstruction, install pandora with following plugins:

```bash

SGM regularization

pip install pandora[sgm]

MCCNN AI matching cost capability (heavy!)

pip install pandora[mccnn] ```

Quick Start

```bash

Download configuration file

wget https://raw.githubusercontent.com/CNES/Pandora/master/datasamples/jsonconffiles/alocalblockmatching.json

Download data samples

wget https://raw.githubusercontent.com/CNES/Pandora/master/data_samples/images/cones.zip

Uncompress data

unzip cones.zip

Run pandora

pandora alocalblockmatching.json outputdir

Left and right disparity maps are saved in outputdir: leftdisparity.tif and right_disparity.tif

```

Documentation

To go further, please consult our online documentation.

Credits

  • Scharstein, D., & Szeliski, R. (2002). A taxonomy and evaluation of dense two-frame stereo correspondence algorithms. International journal of computer vision, 47(1-3), 7-42.
  • Scharstein, D., & Szeliski, R. (2003, June). High-accuracy stereo depth maps using structured light. In IEEE Computer Society Conference on Computer Vision and Pattern Recognition, 2003. Proceedings. (Vol. 1, pp. I-I).
  • 2003 Middleburry dataset (D. Scharstein & R. Szeliski, 2003).

Related

Plugin_LibSGM - Stereo Matching Algorithm plugin for Pandora
Plugin_MC-CNN - MC-CNN Neural Network plugin for Pandora
Pandora2D - CNES Image Registration framework based on Pandora, with 2D disparity maps. CARS - CNES 3D reconstruction software

References

Please cite the following papers when using Pandora:

  • Cournet, M., Sarrazin, E., Dumas, L., Michel, J., Guinet, J., Youssefi, D., Defonte, V., Fardet, Q., 2020. Ground-truth generation and disparity estimation for optical satellite imagery. ISPRS - International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences.
  • Youssefi D., Michel, J., Sarrazin, E., Buffe, F., Cournet, M., Delvit, J., L’Helguen, C., Melet, O., Emilien, A., Bosman, J., 2020. Cars: A photogrammetry pipeline using dask graphs to construct a global 3d model. IGARSS - IEEE International Geoscience and Remote Sensing Symposium.

Owner

  • Name: CNES
  • Login: CNES
  • Kind: organization

GitHub Events

Total
  • Watch event: 10
  • Delete event: 2
  • Member event: 1
  • Push event: 45
  • Fork event: 4
  • Create event: 6
Last Year
  • Watch event: 10
  • Delete event: 2
  • Member event: 1
  • Push event: 45
  • Fork event: 4
  • Create event: 6

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 492
  • Total Committers: 14
  • Avg Commits per committer: 35.143
  • Development Distribution Score (DDS): 0.813
Past Year
  • Commits: 201
  • Committers: 7
  • Avg Commits per committer: 28.714
  • Development Distribution Score (DDS): 0.711
Top Committers
Name Email Commits
Natalia Jimenez n****z@c****u 92
Quentin Fardet q****t@c****u 83
Alice de Bardonnèche-Richard a****d@c****u 80
Marie Leconte m****e@c****u 50
Veronique Defonte v****e@c****r 47
Loic Dumas l****s@c****r 44
Philippe Mallet-Ladeira p****a@c****u 40
yoann y****x@c****r 23
Emmanuel Dubois e****s@c****r 10
Roux Mathis m****x@c****u 10
Emmanuelle Sarrazin e****n@c****r 6
douzief f****h@c****u 3
Quentin FARDET q****t@c****r 3
Véronique DEFONTE v****e@c****u 1
Committer Domains (Top 20 + Academic)
csgroup.eu: 7 c-s.fr: 4 cnes.fr: 2 cs-net.eu: 1

Issues and Pull Requests

Last synced: almost 2 years ago

All Time
  • Total issues: 2
  • Total pull requests: 5
  • Average time to close issues: 19 days
  • Average time to close pull requests: about 1 month
  • Total issue authors: 2
  • Total pull request authors: 3
  • Average comments per issue: 1.5
  • Average comments per pull request: 1.0
  • Merged pull requests: 2
  • 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
View more stats
Top Authors
Issue Authors
  • SylvainJay (1)
  • GasparPizarro (1)
Pull Request Authors
  • dumasl (3)
  • fchapoton (2)
  • qfardet (1)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 1,886 last-month
  • Total dependent packages: 3
  • Total dependent repositories: 1
  • Total versions: 26
  • Total maintainers: 5
pypi.org: pandora

Pandora is a stereo matching framework that helps emulate state of the art algorithms

  • Versions: 26
  • Dependent Packages: 3
  • Dependent Repositories: 1
  • Downloads: 1,886 Last month
Rankings
Downloads: 4.0%
Stargazers count: 9.0%
Dependent packages count: 10.1%
Forks count: 10.2%
Average: 11.0%
Dependent repos count: 21.6%
Maintainers (5)
cars-cnes duboise dyoussef esarrazin mleconte
Last synced: 10 months ago

Dependencies

notebooks/notebook_requirements.txt pypi
  • bokeh *
  • graphviz *
  • ipyvolume *
  • json-checker *
  • matplotlib *
  • numba >=0.47.
  • numpy *
  • pandora-plugin-libsgm *
  • rasterio *
  • scikit-image *
  • scipy *
  • transitions *
  • xarray >=0.13.
.github/workflows/pandora_ci.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • codecov/codecov-action v1 composite
  • pypa/gh-action-pypi-publish release/v1 composite
Dockerfile docker
  • ubuntu 20.04 build
pyproject.toml pypi
setup.py pypi