# `analyze.analyze.ellipse`

The function [`analyze.ellipse`](#digger.analyze.ellipse.ellipse) analyzes a best-fit ellipse to the landlide material through time.

It is called using the following syntax:

```{literalinclude} ../../../../../examples/post-run/barry_arm/setpostprocess.py
:language: python
:start-after: Block 7 Start
:end-before: Block 7 End
```

:::{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.

```{figure} ../../../../_static/from_examples/ellipse_map.png
:alt: Example digger.analyze.ellipse summary figure.

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.