cars.applications.dense_matching.dense_matching

this module contains the abstract matching application class.

Module Contents

Classes

DenseMatching

AbstractDenseMatching

class cars.applications.dense_matching.dense_matching.DenseMatching(conf=None)

Bases: cars.applications.application_template.ApplicationTemplate

AbstractDenseMatching

available_applications: Dict
default_application = 'census_sgm'
classmethod __init_subclass__(short_name, **kwargs)
abstract get_optimal_tile_size(disp_min, disp_max)

Get the optimal tile size to use during dense matching.

Parameters
  • disp_min – minimum disparity

  • disp_max – maximum disparity

Returns

optimal tile size

abstract get_margins(grid_left, disp_min=None, disp_max=None)

Get Margins needed by matching method, to use during resampling

Parameters
  • grid_left – left epipolar grid

  • disp_min – minimum disparity

  • disp_max – maximum disparity

Returns

margins, updated disp_min, updated disp_max

abstract run(epipolar_images_left, epipolar_images_right, orchestrator=None, pair_folder=None, pair_key='PAIR_0', mask1_ignored_by_corr: List[int] = None, mask2_ignored_by_corr: List[int] = None, mask1_set_to_ref_alt: List[int] = None, mask2_set_to_ref_alt: List[int] = None, disp_min=None, disp_max=None)

Run Matching application.

Create left and right CarsDataset filled with xarray.Dataset , corresponding to epipolar disparities, on the same geometry that epipolar_images_left and epipolar_images_right.

Parameters
  • epipolar_images_left (CarsDataset) – tiled left epipolar

  • epipolar_images_right (CarsDataset) – tiled right epipolar

  • orchestrator – orchestrator used

  • pair_folder (str) – folder used for current pair

  • pair_key (str) – pair id

  • mask1_ignored_by_corr (list) – values used in left mask to ignore in correlation

  • mask2_ignored_by_corr (list) – values used in right mask to ignore in correlation

  • mask1_set_to_ref_alt (list) – values used in left mask to altitude to ref

  • mask2_set_to_ref_alt (list) – values used in right mask to altitude to ref

  • disp_min (int) – minimum disparity

  • disp_max (int) – maximum disparity

Returns

left disparity map, right disparity map

Return type

Tuple(CarsDataset, CarsDataset)