Pandora

Pandora, a stereo matching framework

Python Contributions welcome License Documentation Github Action Codecov Binder

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:

pip install pandora

For stereo reconstruction, install pandora with following plugins:

# SGM regularization
pip install pandora[sgm]
#  MCCNN AI matching cost capability (heavy!)
pip install pandora[mccnn]

Quick Start

# Download configuration file
wget https://raw.githubusercontent.com/CNES/Pandora/master/data_samples/json_conf_files/a_local_block_matching.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 a_local_block_matching.json output_dir

# Left and right disparity maps are saved in output_dir: left_disparity.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.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

6 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for alexandre-constantin from gravatar.com alexandre-constantin Avatar for cars-cnes from gravatar.com cars-cnes Avatar for duboise from gravatar.com duboise
+3 more Avatar for dyoussef from gravatar.com dyoussef Avatar for esarrazin from gravatar.com esarrazin Avatar for mleconte from gravatar.com mleconte

Credits

Author: CNES

Requires

Python >=3.10

Provides Extra

dev test sgm mccnn docs notebook

Report project as malware

Download files

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

Source Distribution

pandora-1.9.0.tar.gz (42.6 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

pandora-1.9.0-cp313-cp313-win_amd64.whl (2.0 MB view details)

Uploaded CPython 3.13Windows x86-64

pandora-1.9.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.1 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pandora-1.9.0-cp312-cp312-win_amd64.whl (2.0 MB view details)

Uploaded CPython 3.12Windows x86-64

pandora-1.9.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.1 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pandora-1.9.0-cp311-cp311-win_amd64.whl (2.0 MB view details)

Uploaded CPython 3.11Windows x86-64

pandora-1.9.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.0 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pandora-1.9.0-cp310-cp310-win_amd64.whl (2.0 MB view details)

Uploaded CPython 3.10Windows x86-64

pandora-1.9.0-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (1.0 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

File details

Details for the file pandora-1.9.0.tar.gz.

File metadata

  • Download URL: pandora-1.9.0.tar.gz
  • Upload date:
  • Size: 42.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pandora-1.9.0.tar.gz
Algorithm Hash digest
SHA256 b4b4a2b6028c34d498d89ef650dbefcfcdef7628e3e09d39d7d0bce52759a68d
MD5 6fe9135b22ed065c627e9982edd4529c
BLAKE2b-256 9dc30eff8324139f701df979c5f59ace2f44e732aa8d60799fd1c1c56f25f079

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0.tar.gz:

Publisher: pandora_ci.yml on CNES/Pandora

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pandora-1.9.0-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: pandora-1.9.0-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pandora-1.9.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 e18cfe8352898b193b9e62a5f44929b2652e38ed70c64741e1785efc69efa026
MD5 e43f7cf54317d4880bd0d84b1e4481ab
BLAKE2b-256 e0925e403000143d2c59b650d06e8a80ac8f233d969effd77fcd9bb2a2b37956

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0-cp313-cp313-win_amd64.whl:

Publisher: pandora_ci.yml on CNES/Pandora

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pandora-1.9.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for pandora-1.9.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 d066f1c21ff848e0403c056f0f9540ced5fc3ba85471af3d9aa7bae799298a4c
MD5 33c58a426b8b6e9652bae64d2484fe40
BLAKE2b-256 75305d89a191d251909808707a60b95cbd6445bafa444add6cc2ad3c162024af

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: pandora_ci.yml on CNES/Pandora

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pandora-1.9.0-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: pandora-1.9.0-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pandora-1.9.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 65552d4023b95edc36907fb0b1232987dcd352f6b534515ffbcb87da1983c69b
MD5 0f630ec460b02e3e25eb29b9515e69d0
BLAKE2b-256 0d9bd97760d84e2fe3df5aaea2e26e60c14b8aa590b595b976806cc19ac46138

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0-cp312-cp312-win_amd64.whl:

Publisher: pandora_ci.yml on CNES/Pandora

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pandora-1.9.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for pandora-1.9.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 f7e7118d886104b66fb8ef8b93843f466007bd51a3bba4481390ba9eed0afed2
MD5 c4e3102d4ac3d0d016baacbfd506fb39
BLAKE2b-256 62e579696fef0e1530709c382729bb8ee67f328d49db5b4bc3c6631bafccdce5

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: pandora_ci.yml on CNES/Pandora

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pandora-1.9.0-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: pandora-1.9.0-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pandora-1.9.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 65580552fd53b100b5288f8641b74fbc51c828d2602b52c95e6dcf69bb198379
MD5 06227ba3ee0915957c45456a35a6df3a
BLAKE2b-256 97b125b5ed6d184efecc35f2556762944999c0a7378d9f24bf58975a723ab50e

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0-cp311-cp311-win_amd64.whl:

Publisher: pandora_ci.yml on CNES/Pandora

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pandora-1.9.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for pandora-1.9.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a57c451e02b99ec35388617d981d551b932ba9ffca2504bfc71414d64258d1bc
MD5 a54d3579f5614299480ca0c99b248dea
BLAKE2b-256 1539c89be7fe57e665213a51fa808e41d6215aeabb1bd82a54875f36102567ec

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: pandora_ci.yml on CNES/Pandora

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pandora-1.9.0-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: pandora-1.9.0-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pandora-1.9.0-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 7d47596346900c06d29aac7bb4efb991143a774fa8283a673d373a8fcf3e3490
MD5 d9bf9c1b775b92662e4cda115828bb41
BLAKE2b-256 2c62e0ee8ba23ec3c69210b206aaf5c7de66f159a80bdeb246d9c379e33745c9

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0-cp310-cp310-win_amd64.whl:

Publisher: pandora_ci.yml on CNES/Pandora

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pandora-1.9.0-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for pandora-1.9.0-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8eee25568a0da16e65322f025a1518c7de58664ae6fe9a0514f8288ea93b71cc
MD5 ad5ef907bd5ba4ac13d52cbc523d313a
BLAKE2b-256 947897823cd7df419b3b8fd6877e4018b2dc591c989d644787d4463fdf111c25

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: pandora_ci.yml on CNES/Pandora

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.9.0 This release

9 files

Pre-release

1.9.0a1

9 files

1.8.1

9 files

Pre-release

1.8.1a2

9 files

Pre-release

1.8.1a1

9 files

1.8.0

9 files

Pre-release

1.8.0a1

9 files

1.7.2

11 files

Pre-release

1.7.2a1

11 files

1.7.1

11 files

Pre-release

1.7.1a1

11 files

1.7.0

11 files

1.6.4

11 files

1.6.3

26 files

Pre-release

1.6.3a1

26 files

1.6.2

1 file

Pre-release

1.6.2a1

1 file

1.6.1

1 file

Pre-release

1.6.1a2

1 file

Pre-release

1.6.1a1

1 file

1.6.0

1 file

Pre-release

1.6.0a2

1 file

Pre-release

1.6.0a1

1 file

1.5.0

1 file

1.4.0

1 file

1.3.0

1 file

1.2.2

1 file

1.2.1

1 file

1.2.0

1 file

1.1.1

1 file

1.1.0

1 file

1.0.0

1 file

0.5.1

1 file

0.5.0

1 file

0.2.1

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page