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 Residual
,
which represents the difference between model and data, and a
Metric
,
which is a calculated value on either model or data. The set of currently
supported calculations can be found in the
umami.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.