dycdtools: an R Package for Assisting Calibration and Visualising Outputs of an Aquatic Ecosystem Model

The high complexity of aquatic ecosystem models (AEMs) necessitates a large number of parameters that need calibration, and visualisation of their multifaceted and multi-layered simulation results is necessary for effective communication. Here we present an R package “dycdtools” that contains calibration and post-processing tools for a widely applied aquatic ecosystem model (DYRESM-CAEDYM). The calibration assistant function within the package automatically tests a large number of combinations of parameter values and returns corresponding values for goodness-of-fit, allowing users to narrow parameter ranges or optimise parameter values. The post-processing functions enable users to visualise modelling outputs in four ways: as contours, profiles, time series, and scatterplots. The “dycdtools” package is the first open-source calibration and post-processing tool for DYRESM-CAEDYM, and can also be adjusted for other AEMs with a similar structure. This package is useful to reduce the calibration burden for users and to effectively communicate model results with a broader community.

Songyan Yu (Griffith University) , Christopher G. McBride (University of Waikato) , Marieke A. Frassl (Griffith University) , Matthew R. Hipsey (The University of Western Australia) , David P. Hamilton (Griffith University)
2023-02-10

Supplementary materials

Supplementary materials are available in addition to this article. It can be downloaded at RJ-2023-008.zip

References

Reuse

Text and figures are licensed under Creative Commons Attribution CC BY 4.0. The figures that have been reused from other sources don't fall under this license and can be recognized by a note in their caption: "Figure from ...".

Citation

For attribution, please cite this work as

Yu, et al., "dycdtools: an R Package for Assisting Calibration and Visualising Outputs of an Aquatic Ecosystem Model", The R Journal, 2023

BibTeX citation

@article{RJ-2023-008,
  author = {Yu, Songyan and McBride, Christopher G. and Frassl, Marieke A. and Hipsey, Matthew R. and Hamilton, David P.},
  title = {dycdtools: an R Package for Assisting Calibration and Visualising Outputs of an Aquatic Ecosystem Model},
  journal = {The R Journal},
  year = {2023},
  note = {https://doi.org/10.32614/RJ-2023-008},
  doi = {10.32614/RJ-2023-008},
  volume = {14},
  issue = {4},
  issn = {2073-4859},
  pages = {235-251}
}