Digger

Digger is a python package that provides a number of pre- and post-processing tools for working with landslide runout models. It has been tailored for use with the D-Claw model. It may also be useful for initializing and postprocessing the results of other runout models.

D-Claw requires input files and generates output files in very specific formats. Simulation output generates files in a specific format (see the clawpack documentation for more detail). The purpose of this package is to make it easier to create these input files and conduct semi-standard analyses on the output files.

The package is broken into modules that focus on different tasks within a typical runout modeling workflow. digger.make provides functions that make spatially variable input files (e.g., depth of landslide material). digger.analyze provides functions to analyze simulation output. digger.compare provides functions that compare simulation output with observations. Finally, digger.utils provides many utility functions for use with digger-enabled workflows.

License

Digger uses the GPLv3 license. Read more about this license here.

Using the documentation

The documentation contains multiple elements. Most users should start with the User Guide, which provides an overview of what digger does. Next, look through the examples within the user guide, which describe some example applications. Should a user find that they want to install and use digger themselves, they can refer to the installation instructions.

Finally, refer to the API for function-level documentation.

Note

digger is scientific software. A user should expect to gain a high-level understanding of what is being done by each function using the documentation. For detailed understanding, a user should expect to read the source code of the functions they are using.

Warning

digger was designed to make it easier to run D-Claw, a model based on the clawpack package. This documentation presumes knowledge of how D-Claw and clawpack applications are specified. Where most relevant, links to clawpack documentation are provided. Without knowledge of clawpack application specification and file formats, some aspects of digger may be confusing.

Citation

If you use digger in a publication, cite it as follows:

Barnhart, K.R., George, D. L., Collins, A.L., Amaral, T.O., 2024, digger -
Utility tools for landslide runout modeling, version 1.1: U.S. Geological
Survey software release, https://doi.org/10.5066/P14TUMBB.

Bibtex:

@misc{barnhart2024digger,
    title = {digger - Utility tools for landslide runout modeling, version 1.1},
    author = {Barnhart, K.R. and George, D. L. and Collins, A.L. and Amaral, T.O.},
    url = {https://code.usgs.gov/ghsc/lhp/digger},
    year = {2024},
    doi = {10.5066/P14TUMBB}
}