Skip to Main content Skip to Navigation
Journal articles

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

Daniel Ayllón 1 Steven Railsback 2 Cara Gallagher 3 Jacqueline Augusiak 4 Hans Baveco 5, 6 Uta Berger 7, 8 Sandrine Charles 9 Romina Martin 10 Andreas Focks 5, 6 Nika Galic 11 Chun Liu 12, 13 E. Emiel van Loon 14 Jacob Nabe-Nielsen 3 Cyril Piou 15, 16 J. Gareth Polhill 17 Thomas Preuss 18 Viktoriia Radchuk 19 Amelie Schmolke 20 Julita Stadnicka-Michalak 21 Pernille Thorbek 22 Volker Grimm 23, 24
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." Highlights: • The quality and reproducibility of modelling would be increased by keeping modelling notebooks. • Simulation modellers have not yet developed a strong culture of keeping notebooks. • We propose a standard format for notebooks based on the TRACE document framework. • We make recommendations about the type of information to be included in the notebooks. • We describe existing tools to keep notebooks.
Document type :
Journal articles
Complete list of metadata

https://hal.inrae.fr/hal-03166935
Contributor : Christine Riou <>
Submitted on : Thursday, March 11, 2021 - 4:02:06 PM
Last modification on : Tuesday, July 20, 2021 - 5:20:04 PM

Links full text

Identifiers

Citation

Daniel Ayllón, Steven Railsback, Cara Gallagher, Jacqueline Augusiak, Hans Baveco, et al.. Keeping modelling notebooks with TRACE: Good for you and good for environmental research and management support. Environmental Modelling & Software, Elsevier, 2021, 136, pp.104932. ⟨10.1016/j.envsoft.2020.104932⟩. ⟨hal-03166935⟩

Share

Metrics

Record views

57