analyze.analyze.ellipse

The function analyze.ellipse analyzes a best-fit ellipse to the landslide material through time.

It is called using the following syntax:

# Ellipse analysis
from digger import analyze

analyze.ellipse(
    csvout="ellipse.csv",
    shpout="ellipse.shp",
    plot=True,
    epsg=26906,
    njobs=3,
    stride=1,
)

Attention

This code snippet is not fully self-sufficient. This snippet relies on simulation output files. To reproduce the example, execute the file digger/examples/post-run/barry_arm/setpostprocess.py from within the directory in which it is located. Before the script is executed either the example simulation must be run or the file digger/data/barry_arm_output.zip must be unzipped and the resulting directory (_output) must be placed within digger/examples/post-run/barry_arm/.

It generates a diagnostic figure that visualizes each area identified.

Example digger.analyze.ellipse summary figure.

Fig. 13 An example of the diagnostic output provided by digger.analyze.ellipse.

It also generates a csv file summarizing information about the ellipse area and position.