Overviews
Diagram
The following interactive diagram highlights all stereo steps avalaible in Pandora.
Note
Dark red blocks represent mandatory steps.
Pink blocks represent optional steps.
Configuration file
The configuration file provides a list of parameters to Pandora so that the processing pipeline can run according to the parameters choosen by the user.
Pandora works with JSON formatted data with the following nested structures.
{
"input" :
{
...
},
"pipeline" :
{
...
}
}
All configuration parameters are described in Inputs and Step by step chapters. As shown on the diagram, stereo steps must respect on order of priority, and can be called multiple times as explain on Sequencing chapter.
Note
The right disparity map can be computed if right_disp_map parameter is activated. See Outputs.
Example
Install
pip install pandora[sgm]
Create a configuration file
{
"input":
{
"img_left": "tests/pandora/left.png",
"img_right": "tests/pandora/right.png",
"disp_min": -60,
"disp_max": 0
}
,
"pipeline" :
{
"right_disp_map":
{
"method": "accurate"
},
"matching_cost" :
{
"matching_cost": "census",
"window_size": 5,
"subpix": 1
},
"optimization" :
{
"optimization_method": "sgm",
"P1": 8,
"P2": 32,
},
"disparity":
{
"disparity_method": "wta",
"invalid_disparity": "NaN"
},
"refinement":
{
"refinement_method": "vfit"
},
"filter" :
{
"filter_method": "median",
"filter_size": 3
},
"validation" :
{
"validation_method": "cross_checking",
"cross_checking_threshold": 1
},
"filter.after.validation" :
{
"filter_method": "median",
"filter_size": 3
}
}
}
Run Pandora
pandora config.json output/