Modelling Aquatic Eco-Dynamics: Overview of the AED modular simulation platform

Welcome!

This is the online home of Modelling Aquatic Eco-Dynamics, a book on describing the AED (previously released as AED2) modelling platform for the simulation of aquatic ecosystem dynamics.

Inspired by bookdown and the Open Data movement in ecology and the environmental sciences, this book is open source. This encourages a collaborative approach to model development and discussion and ensures the approaches adopted by the user community are reproducible and publicly accessible for people worldwide.

The model platform has been applied to many diverse sites across the globe (Figure 0.1) and we hope it can be useful to help with your application!

Figure 0.1: Locations

How to contribute?

You may be a new user seeking to understand how to get started, or you may be interested in tailoring a module to your research or management application. As modules evolve, through incremental improvements or wholesale changes, the experts working on these changes can ensure the latest information is available to the community by continuously updating and improving this book.

bookdown makes editing a book as easy as editing a wiki, provided you have a GitHub account (sign-up at github.com). Once logged-in to GitHub, click on the ‘edit me’ icon highlighted with a red ellipse in the image below.

This will take you to an editable version of the the source R Markdown file that generated the page you’re on:

To raise an issue about the book’s content (e.g. code not running) or make a feature request, check-out the issue tracker.

Readers may also use the hypothes.is utility on the right margin of the book to add personal annotations and public comments on the book content.

Maintainers and contributors must follow this repository’s CODE OF CONDUCT.

Editing the book

To build the book locally, clone or download the aed-science repo, load R in root directory (e.g. by opening aed-sceince.Rproj in RStudio) and run the following lines:

bookdown::render_book("index.Rmd") # to build the book
browseURL("_book/index.html") # to view it

How to cite this book

Please cite this edited book and the AED model in scientific publications as: Hipsey, M.R., ed. (2022) Modelling Aquatic Eco-Dynamics: Overview of the AED modular simulation platform. Zenodo repository. DOI: 10.5281/zenodo.6516222.

If you would like to cite an individual chapter of this book (not the AED model), please use this format (example given here for chapter 4): Hipsey, M.R. and P. Huang. (2022) Chapter 4. Dissolved oxygen. Hipsey, M.R., ed. Modelling Aquatic Eco-Dynamics: Overview of the AED modular simulation platform. Zenodo repository. DOI: 10.5281/zenodo.6516222.

Supporting the project

If you find AED useful, please support it by:

  • Telling people about it
  • Join our Slack channel: general-lake-model.slack.com
  • Communicating about the model in digital media, e.g. via the “AEDmodel” hashtag on Twitter
  • Citing the book, as described above
  • Contributing to this book via GitHub or the AED model more broadly via Github

Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.