16.72. stereo_sweep

This program runs parallel_stereo with different parameter combinations and portions of input images.

16.72.1. Example

stereo_sweep                             \
  --param-sweep                          \
    "--corr-kernel 7,7 9,9
    --stereo-algorithm asp_sgm asp_mgm
    --subpixel-mode 1 9
    --proj-win -180,3873,3287,180
               -947,1418,3022,-2752"     \
  --param-sweep                          \
    "--corr-kernel 19,19 21,21
    --stereo-algorithm asp_bm
    --subpixel-mode 1 3"                 \
  left_map_image.tif right_map_image.tif \
  left_cam.xml right_cam.xml             \
  --dem dem.tif                          \
  --point2dem-params                     \
    "--tr 4.0
     --orthoimage
     --errorimage"                       \
  --output-dir stereo_out

Note that the option --param-sweep is specified twice, with each resulting in a set of runs. For the first one, there are two possible values for the correlation kernel, two stereo algorithms, two subpixel modes, and two image regions (projection windows). This results in a total of 16 different runs of parallel_stereo. For the second --param-sweep, there are two kernel sizes, one stereo algorithm, and two subpixel modes, resulting in 4 runs on the full image extents.

Parameters with multiple values (like --corr-kernel 7,7 or --proj-win) have commas as separator, with no spaces. This is necessary so --param-sweep can be parsed correctly. The commas are replaced with spaces when passing the arguments to parallel_stereo (Section 17).

The point2dem command will be run on each output of parallel_stereo. Arguments to it can be passed via the --point2dem-params option. See Section 16.72.3 for more details.

16.72.2. Workflow

This program generates a file named run_index.csv in the output directory that enumerates the run directories and corresponding parameter values.

When the images are mapprojected already (Section 6.1.7), pass the mapprojection DEM to --dem. This allows sweeping over different clips with --proj-win. Otherwise, an individual clip can be passed in to parallel_stereo, if desired, via --left-image-crop-win and --right-image-crop-win.

Any other options will be passed directly to parallel_stereo.

16.72.3. Command-line options

--param-sweep <string>

Parameter sweep. Must be in quotes. Multiple such options can be specified. Each defines a different set of parameter combinations to test. See Section 16.72.1 for an example.

--output-dir <string>

Output directory.

--dem <string>

Input DEM for mapprojection. Required if using --proj-win in parameter sweeps.

--point2dem-params <string>

Parameters to pass to point2dem. If --orthoimage (with no argument) is passed in, the needed L.tif will be passed to each created point2dem command.

--dry-run

Print commands without executing them.

--help

Display the help message and exit.