topo_doc module

topo_doc.classify_inventory_tda(earthquake_inventory_features, rainfall_inventory_features, test_inventory_features)

function to give probability of testing inventory belonging to earthquake and rainfall class

Parameters:

earthquake_inventory_features (array_like)

TDA features of known earthquake inventories landslides

rainfall_inventory_features (array_like)

TDA features of known rainfall inventories landslides

test_inventory_features (array_like)

TDA features of known testing inventory landslides

Returns:

(array_like) probability of testing inventory landslides belonging to earthquake and rainfall class

topo_doc.download_dem(poly_data, dem_location, inventory_name)

function to download the DEM corresponding to inventory region

Parameters:

:poly_data (str) : landslide polygon data in an inventory

dem_location (str)

provide the path where user wants to download DEM

inventory_name (str)

inventory_name to save the dem file

Returns:

(str) downloaded DEM file location for input landslide inventory

topo_doc.get_ml_features(data)

function to get machine learning features from 3D point cloud data

Parameters:

data (array_like)

3D point cloud data of landslides

Returns:

topological features corresponding to 3D point cloud data

topo_doc.make_3d_polygons(poly_data, dem_location, inventory_name, kk)

function to get 3D point cloud from 2D shape of landslide

Parameters:

poly_data (str)

polygons shapefile

dem_location (str)

path of dem file

inventory_name (str)

path of dem file

kk (int)

kk=1 if user have already DEM corresponding to inventory region otherwise use any other number

Returns:

(array_like) 3D data of landslides

topo_doc.min_max_inventory(poly_data, lon_res, lat_res)

function to calculate the bounding box coordinates of complete landslide inventory

Parameters:

poly_data (str)

landslide polygon data in an inventory

lon_res (float)

longitude resolution

lat_res (float)

latitude resolution

Returns:

bounding box coordinates of landslide inventory region

topo_doc.plot_topological_results(predict_proba)

function to visualize the trigger prediction of landslides in testing inventory

Parameters:

predict_proba (array_like)

probability of each landslide in inventory class belonging to earthquake and rainfall class.

Returns:

Visualization of landslide probabilities belong to earthquake and rainfall class and trigger prediction of entire landslide inventory

topo_doc.read_shapefiles(path_filename)

function to read the shapefile from the local file path of landslide inventory

Parameters:

path_filename (str)

path to local inventory shapefiles

Returns:

read shapefile from file path