Introduction

What is ADRIA.jl?

ADRIA is a decision support platform for informing reef restoration and adaptation interventions through scenario exploration and analysis, decision heuristics (MCDA), alongside a small coral ecosystem model.

Common use cases include running scenarios under different environmental and intervention conditions (see Loading a Domain, Generating scenarios and Running scenarios), extracting metrics for each scenario and timestep such as coral cover, shelter volume or number of juveniles (see Metrics), performing analyses like time series clustering (see Analysis), and using the visualization tools to plot metrics and analysis results.

Docker documentation

ADRIA.jl features a set of Docker build targets which allow usage, development and experimentation of the ADRIA Julia package. See ADRIA Docker Setup for more information.

Troubleshooting F.A.Q

ADRIA.jl is under active development and from time to time issues may arise. Here are some answers to some issues encountered.

Q. I get this warning when trying to load pre-existing results: Results were produced with a different version of ADRIA (v0.x.x). The installed version of ADRIA is: v0.y.y. Errors may occur when analyzing data. (where x and y are different numbers).

A. The result set being loaded were generated by a different version of ADRIA, and in a possibly incompatible format. Sometimes, results may still be produced/analyzed as normal. In other times, ADRIA.jl or the expected metadata in the result set may have changed leading to errors when conducting analyses.

Either go back to the version indicated, or re-run the scenarios to obtain results in the updated format.

Q. I get an error or warning about an ENV variable not being found or set.

A. Double check the configuration settings in config.toml (see above).

Q. How do I run my own scenarios?

A. Scenarios are defined in a CSV file (with parameter values in columns, so that each row defines a scenario).

• See the example_scenarios.csv file in the ADRIA data specification repository for an idea of what this looks like.

• See Extracting model details example in Cookbook examples on how to extract the model specification and parameter table for a given domain.

• See also the Generating and running scenarios example in Cookbook examples which showcases how to run such a file for a given study area.