pandora2d 1.1.2.dev0

A coregistration tool.

Pandora2d is a tool based on Pandora to provide disparity maps for image pairs with a combination of vertical and horizontal stereo.

Example of use • Install • First Step • To go further • Credits • Related

Example of use

• Not-aligned Sentinel2 images from Ouarzazate's Solar Central.

Before Pandora2D	After Pandora2D

Install

Pandora2D is available on Pypi and can be installed by:

    # Upgrade your pip by running:
    pip install --upgrade pip
    # Install pandora2d latest release
    pip install pandora2d

Quick start

Pandora2d requires a config.json to declare the pipeline and the pair of images to process. Download our data sample to start right away !

• maricopa's pair with combination of vertical and horizontal stereo
• a configuration file

    # Image pairs with a combination of vertical and horizontal stereo
    wget -P data_samples/images https://raw.githubusercontent.com/CNES/Pandora2D/master/data_samples/images/maricopa.zip
    # Config file
    wget -P data_samples/json_conf_files https://raw.githubusercontent.com/CNES/Pandora2D/master/data_samples/json_conf_files/a_basic_pipeline.json
    # Uncompress data
    unzip data_samples/images/maricopa.zip -d data_samples/images
    # run Pandora2d
    pandora2d data_samples/json_conf_files/a_basic_pipeline.json

    # The columns disparity map is saved in  "./data_samples/json_conf_files/a_basic_pipeline_output/disparity_map/col_map.tif".
    # The row disparity map is saved in  "./data_samples/json_conf_files/a_basic_pipeline_output/disparity_map/row_map.tif".

Multiscale mode

This version of pandora2d includes a Minimal Viable Product (MVP) designed to enable multiscale processing with pandora2d.

Instructions for using this multiscale mode are provided in the documentation in the following sections:

• Exploring the field: Multiscale mode
• Userguide: Multiscale mode

Custom configurations and image pyramids are available for testing this multiscale mode. To test them, run this command:

python -m src.pandora2d.multiscale.multiscale data_samples/json_conf_files/a_multiscale_pipeline.json

To go further

To create your own coregistration pipeline and choose among the variety of algorithms we provide, please consult our online documentation.

You will learn:

• which steps you can use and combine
• how to quickly set up a Pandora2D pipeline

Credits

Our data test sample contains modified 'Copernicus Sentinel data [2021]', provided by the Peps Sentinel2 website (CNES).

Related

• Pandora - stereo matching framework