cars.applications.dem_generation.dichotomic_generation

this module contains the dichotomic dem generation application class.

Module Contents

Classes

DichotomicGeneration

DichotomicGeneration

Functions

generate_grid(pd_pc, resolution[, xmin, xmax, ymin, ymax])

Generate regular grid

multi_res_rec(pd_pc, list_fun, x_grid, y_grid, ...)

Recursive function to fill grid with results of given functions
class cars.applications.dem_generation.dichotomic_generation.DichotomicGeneration(conf=None)[source]

Bases: cars.applications.dem_generation.dem_generation.DemGeneration

DichotomicGeneration

check_conf(conf)[source]

Check configuration

Parameters

conf (dict) – configuration to check

Returns

overloaded configuration

Return type

dict

run(triangulated_matches_list, output_dir, geoid_path, dem_roi_to_use=None, initial_elevation=None, cars_orchestrator=None)

Run dichotomic dem generation using matches

Parameters

  • triangulated_matches_list (list(pandas.Dataframe)) – list of triangulated matches positions must be in a metric system

  • output_dir (str) – directory to save dem

  • geoid_path – geoid path

  • cars_orchrestrator – the main cars orchestrator

  • dem_roi_to_use – dem roi polygon to use as roi

  • initial_elevation – the path to the initial elevation file

Returns

dem data computed with mean, min and max, and new initial elevation file. dem is also saved in disk, and paths are available in attributes. (DEM_MEDIAN_PATH, DEM_MIN_PATH, DEM_MAX_PATH)

Return type

Tuple(CarsDataset, str | None)

cars.applications.dem_generation.dichotomic_generation.generate_grid(pd_pc, resolution, xmin=None, xmax=None, ymin=None, ymax=None)[source]

Generate regular grid

Parameters

  • pd_pc (Pandas Dataframe) – point cloud

  • resolution (float) – resolution in meter

  • xmin (float) – x min position in metric system

  • xmax (float) – x max position in metric system

  • ymin (float) – y min position in metric system

  • ymax (float) – y max position in metric system

Returns

regular grid

Return type

numpy array

cars.applications.dem_generation.dichotomic_generation.multi_res_rec(pd_pc, list_fun, x_grid, y_grid, list_z_grid, row_min, row_max, col_min, col_max, min_number_matches, overlap)[source]

Recursive function to fill grid with results of given functions

Parameters

  • pd_pc (Pandas Dataframe) – point cloud

  • list_fun (list(function)) – list of functions

  • x_grid (numpy array) – x grid

  • y_grid (numpy array) – y grid

  • list_z_grid (list(numpy array)) – list of z grid computed with functions

  • row_min (int) – row min

  • row_max (int) – row max

  • col_min (int) – col min

  • col_max (int) – col max

  • min_number_matches (int) – minimum of matches: stop condition

  • overlap (float) – overlap to use for include condition