Pre-release

This release is a pre-release and may not be stable for production use.

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:
Newer release available (1.9.0)

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.0a1.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.0a1-cp313-cp313-win_amd64.whl (2.0 MB view details)

Uploaded CPython 3.13Windows x86-64

pandora-1.9.0a1-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.0a1-cp312-cp312-win_amd64.whl (2.0 MB view details)

Uploaded CPython 3.12Windows x86-64

pandora-1.9.0a1-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.0a1-cp311-cp311-win_amd64.whl (2.0 MB view details)

Uploaded CPython 3.11Windows x86-64

pandora-1.9.0a1-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.0a1-cp310-cp310-win_amd64.whl (2.0 MB view details)

Uploaded CPython 3.10Windows x86-64

pandora-1.9.0a1-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.0a1.tar.gz.

File metadata

  • Download URL: pandora-1.9.0a1.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.0a1.tar.gz
Algorithm Hash digest
SHA256 f70373bfd77edcd90af4ad0a3b6ee91325fab494d388243818b1484ecac8ab80
MD5 39879914f11c812f0b7485967decdf9b
BLAKE2b-256 6e78aba2c7e4e9afd1a3cc4d7d10d974b3db8014d4cdf3639ae348a0db15b084

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0a1.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.0a1-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: pandora-1.9.0a1-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.0a1-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 bbf97005933f23495860e4c5d253e277cf0029ceaf5d5c925b3951945b0a2b8b
MD5 135e9c7bb7a1bcaecf21172f4886c9fd
BLAKE2b-256 ded611328767691c67283d9296c813c550322bb4739f55b1a11a5b8dd6aefe82

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0a1-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.0a1-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for pandora-1.9.0a1-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 5202592a9023492e16aaad3b6efd982144922e86e254b6525c6745a7b85efc20
MD5 38c4fb77be2ebb22f8d4c03eb2a2522b
BLAKE2b-256 7103ffc7fab393c15e2797fe7b7d39d86e1e277c84140d64d39007cd2c384bfc

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0a1-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.0a1-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: pandora-1.9.0a1-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.0a1-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 ff036236f22955a92de7d014c711131bc4ef2f0a708972f1e755d9a7adaaad9a
MD5 aec7a285f797b9a8712a0aae125df556
BLAKE2b-256 5994d4310ef8af3d6082a8bc8ef0c7b7b684075a710cc7fb2ea68d27f1da1a5e

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0a1-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.0a1-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for pandora-1.9.0a1-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 29836b134bc0e386767dfb95e655f81e210ebb4fb3dde6a1ee0cb956b3c38afb
MD5 53ce3f105774bf6ade4693d4e0156586
BLAKE2b-256 c9c507f7be34191dae7a7b833941d5b26ffbd7c214b9d94ed00af85ca8e230f9

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0a1-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.0a1-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: pandora-1.9.0a1-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.0a1-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 53d497205be9d5a69ab40d711c33ab7b285c517ac333378d04ad94b630e4ba81
MD5 8c9f7bf594e4cdcd9ab9cfaea14d7c47
BLAKE2b-256 a1c327322d950c48f2541ef8a6475e63f7fd292badf3d919aa779b3a6fe0d5b7

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0a1-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.0a1-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for pandora-1.9.0a1-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8a32520ae0c94db6f167f273a126b330749fad50fadce07a660c13834a6dab26
MD5 62dd306f848e5f7971d7f05882e43389
BLAKE2b-256 fc7594b22db569c00ff2d65277bf4ae40079007853bb3c73b6e07b886f3f7049

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0a1-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.0a1-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: pandora-1.9.0a1-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.0a1-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 0b774129777077871ed59fcea6c18b6d387f30ff8e1a8e625d69dc50907afe5c
MD5 dbe45f970128f5e505b12ae3af6e0e85
BLAKE2b-256 7a5e4f4c7189818d2b58b2a3a23572bc8977b0bbce258239b2e3cb9c46804516

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0a1-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.0a1-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for pandora-1.9.0a1-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 2bacba371829234db7feebd92739913b60646aa78372690e30ea9a8235164892
MD5 f6becc4ef0e3a0c0cc91d19a7580c3a4
BLAKE2b-256 861002a85519c8f2f58de2a4ecc3bf5009e642761a6abfe60a57510364357ef8

See more details on using hashes here.

Provenance

The following attestation bundles were made for pandora-1.9.0a1-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

1.9.0

9 files

This release
Pre-release

1.9.0a1 This release

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