Skip to content

Latest commit

 

History

History
91 lines (63 loc) · 2.58 KB

index.rst

File metadata and controls

91 lines (63 loc) · 2.58 KB

Welcome to the Umami documentation!

Introduction and Purpose

Umami is a package for calculating objective functions or objective function components for landscape evolution modeling. It was designed to work well with terrainbento and other models built with the Landlab Toolkit. Examples can be found in the notebooks on Binder (or in the notebooks directory).

Umami offers two primary classes: a :pyResidual, which represents the difference between model and data, and a :pyMetric, which is a calculated value on either model or data. The set of currently supported calculations can be found in the :pyumami.calculations submodule.

Umami was designed to provide an input-file based interface for calculating single-value landscape metrics for use in model analysis. This supports reproducible analysis and systematic variation in metric construction. When used with terrainbento, one input file can describe the model run, and another input file can describe the model assessment or model-data comparison. This streamlines model analysis applications. Umami also provides multiple output formats (YAML and Dakota), the latter of which is designed to interface with Sandia National Laboratory's Dakota package.

The source code is housed on GitHub.

Getting Started

Check out the example notebooks housed on Binder to get a sense of how umami can be used.

Get Help

To get help or ask questions, please make an issue on GitHub.

Installation Instructions

Installation is described in the README .

Contributing

All contributions are welcome. Make an issue on GitHub to file a bug report.

If you are planning to contribute to the source code, please read the following page for more information.

development_practices

API Documentation

umami.residual umami.metric

umami.calculations

Indices and tables

  • genindex
  • modindex
  • search