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

• DOI: 10.1016/j.envsoft.2020.104932
• Publication Date: 2020-11-21T04:22:41Z
• Authors: Daniel Ayllón; Steven F. Railsback; Cara Gallagher; Jacqueline Augusiak; Hans Baveco; Uta Berger; Sandrine Charles; Romina Martin; Andreas Focks; Nika Galic; Chun Liu; E. Emiel van Loon; Jacob Nabe-Nielsen; Cyril Piou; J. Gareth Polhill; Thomas G. Preuss; Viktoriia Radchuk; Amelie Schmolke; Julita Stadnicka-...; Pernille Thorbek; Volker Grimm
• Keywords: http://aims.fao.org/aos/agrovoc/c_24242; Standards; reproductibilité; http://aims.fao.org/aos/agrovoc/c_28664; 330; 550; [SDV]Life Sciences [q-bio]; [SHS.INFO]Humanities and Social Sciences/Library and information sciences; http://aims.fao.org/aos/agrovoc/c_49868; Environmental modelling; modèle de simulation; Modelling cycle; documentation; Reproducible research; http://aims.fao.org/aos/agrovoc/c_2350; 03 medical and health sciences; Scientific communication; Model documentation; http://aims.fao.org/aos/agrovoc/c_37875; [SDE.ES]Environmental Sciences/Environment and Society; http://aims.fao.org/aos/agrovoc/c_7367; http://aims.fao.org/aos/agrovoc/c_3860; modélisation; 0303 health sciences; http://aims.fao.org/aos/agrovoc/c_230ab86c; U10 - Informatique, mathématiques et statistiques; gestion de l'environnement; [INFO.INFO-MO]Computer Science [cs]/Modeling and Simulation; norme; diffusion de la recherche; http://aims.fao.org/aos/agrovoc/c_9000056; modélisation environnementale; diffusion de l'information; U30 - Méthodes de recherche; système d'aide à la décision; http://aims.fao.org/aos/agrovoc/c_8bd2b433

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.”