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)

Bases: cars.applications.dem_generation.dem_generation.DemGeneration

DichotomicGeneration

check_conf(conf)

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)

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

  • dem_roi_to_use – dem roi polygon to use as roi

Returns

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

Return type

CarsDataset

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

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)

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