Keeping modelling notebooks with TRACE: Good for you and good for environmental research and management support

Research output: Contribution to journalResearch articleContributedpeer-review

Contributors

  • Daniel Ayllón - , Complutense University (Author)
  • Steven F. Railsback - , Lang Railsback & Associates (Author)
  • Cara Gallagher - , Aarhus University (Author)
  • Jacqueline Augusiak - , Charles River Laboratories (Author)
  • Hans Baveco - , Wageningen University & Research (WUR) (Author)
  • Uta Berger - , Chair of Forest Biometrics and Systems Analysis (Author)
  • Sandrine Charles - , Universite Claude Bernard Lyon 1 (Author)
  • Romina Martin - , Stockholm University (Author)
  • Andreas Focks - , Wageningen University & Research (WUR) (Author)
  • Nika Galic - , Syngenta (Author)
  • Chun Liu - , Syngenta (Author)
  • E. Emiel van Loon - , University of Amsterdam (Author)
  • Jacob Nabe-Nielsen - , Aarhus University (Author)
  • Cyril Piou - , University of Montpellier (Author)
  • J. Gareth Polhill - , The James Hutton Institute (Author)
  • Thomas G. Preuss - , Bayer AG (Author)
  • Viktoriia Radchuk - , Leibniz Institute for Zoo and Wildlife Research (Author)
  • Amelie Schmolke - , Waterborne Environmental Inc. (Author)
  • Julita Stadnicka-Michalak - , Swiss Federal Institute of Aquatic Science and Technology (Author)
  • Pernille Thorbek - , BASF (Author)
  • Volker Grimm - , Helmholtz Centre for Environmental Research, University of Potsdam (Author)

Abstract

The acceptance and usefulness of simulation models are often limited by the efficiency, transparency, reproducibility, and reliability of the modelling process. We address these issues by suggesting that modellers (1) “trace” the iterative modelling process by keeping a modelling notebook corresponding to the laboratory notebooks used by empirical researchers, (2) use a standardized notebook structure and terminology based on the existing TRACE documentation framework, and (3) use their notebooks to compile TRACE documents that supplement publications and reports. These practices have benefits for model developers, users, and stakeholders: improved and efficient model design, analysis, testing, and application; increased model acceptance and reuse; and replicability and reproducibility of the model and the simulation experiments. Using TRACE terminology and structure in modelling notebooks facilitates production of TRACE documents. We explain the rationale of TRACE, provide example TRACE documents, and suggest strategies for keeping “TRACE Modelling Notebooks.”

Details

Original languageEnglish
Article number104932
JournalEnvironmental Modelling and Software
Volume136
Publication statusPublished - Feb 2021
Peer-reviewedYes

External IDs

ORCID /0000-0001-6920-136X/work/170586969

Keywords

Keywords

  • Environmental modelling, Model documentation, Modelling cycle, Reproducible research, Scientific communication, Standards