cars.applications.point_cloud_outliers_removing.small_components

this module contains the statistical points removing application class.

Module Contents

Classes

SmallComponents

PointCloudOutliersRemoving

Functions

small_components_removing_wrapper(cloud, ...[, ...])

Statistical outlier removing

class cars.applications.point_cloud_outliers_removing.small_components.SmallComponents(conf=None)

Bases: cars.applications.point_cloud_outliers_removing.pc_out_removing.PointCloudOutliersRemoving

PointCloudOutliersRemoving

check_conf(conf)

Check configuration

Parameters

conf (dict) – configuration to check

Returns

overloaded configuration

Return type

dict

get_optimal_tile_size(max_ram_per_worker, superposing_point_clouds=1, point_cloud_resolution=0.5)

Get the optimal tile size to use, depending on memory available

Parameters

• max_ram_per_worker (int) – maximum ram available

• superposing_point_clouds (int) – number of point clouds superposing

• point_cloud_resolution (float) – resolution of point cloud

Returns

optimal tile size in meter

Return type

float

get_method()

Get margins to use during point clouds fusion

Returns

algorithm method

Return type

string

get_on_ground_margin(resolution=0.5)

Get margins to use during point clouds fusion

Returns

margin

Return type

float

run(merged_points_cloud, orchestrator=None)

Run PointCloudOutliersRemoving application.

Creates a CarsDataset filled with new point cloud tiles.

Parameters

• merged_points_cloud (CarsDataset filled with pandas.DataFrame) –

  merged point cloud. CarsDataset contains:

  • Z x W Delayed tiles. Each tile will be a future pandas DataFrame containing:

    • data : with keys : “x”, “y”, “z”, “corr_msk” optional: “clr”, “msk”, “data_valid”,”coord_epi_geom_i”, “coord_epi_geom_j”,”idx_im_epi” - attrs with keys: “epsg”

  • attributes containing “bounds”, “ysize”, “xsize”, “epsg”

• orchestrator – orchestrator used

Returns

filtered merged points cloud. CarsDataset contains:

• Z x W Delayed tiles. Each tile will be a future pandas DataFrame containing:

  • data : with keys : “x”, “y”, “z”, “corr_msk” optional: “clr”, “msk”, “data_valid”,”coord_epi_geom_i”, “coord_epi_geom_j”,”idx_im_epi”

  • attrs with keys: “epsg”

• attributes containing “bounds”, “ysize”, “xsize”, “epsg”

Return type

CarsDataset filled with xr.Dataset

cars.applications.point_cloud_outliers_removing.small_components.small_components_removing_wrapper(cloud, connection_distance, nb_points_threshold, clusters_distance_threshold, save_points_cloud_as_laz, save_points_cloud_as_csv, save_points_cloud_by_pair: bool = False, point_cloud_file_name=None, saving_info=None)

Statistical outlier removing

Parameters

• cloud (pandas DataFrame) – cloud to filter

• connection_distance (float) – connection distance

• nb_points_threshold (int) –

• clusters_distance_threshold (float) –

• save_points_cloud_as_laz (bool) – activation of point cloud saving to laz

• save_points_cloud_as_csv (bool) – activation of point cloud saving to csv

• save_points_cloud_by_pair (bool) – save point cloud as pair

• point_cloud_file_name (str) – point cloud filename

• saving_info (dict) – saving infos

Returns

filtered cloud

Return type

pandas DataFrame