Cracking the code: Linking good modeling and coding practices for new ecological modelers

Abstract

Good modeling practices are essential for producing reliable and reproducible ecological models. Inherent to good modeling practices are fundamental coding and documentation skills, which not only implement the desired modeling capabilities but also clearly outline the goals, methods, and components of a model that are necessary to reproduce the desired results. One of the largest challenges for new ecological modelers can be implementing a model into computer code. In fact, coding represents a significant barrier for entry into ecological modeling, since most ecologists have not had formal training in computer science or software development. While software packages do exist that facilitate model development, we have observed that newer modelers still struggle with developing good coding practice throughout the modeling process. During a series of agent-based modeling short-courses and full semester graduate courses, both taught in NetLogo, we identified some common challenges encountered by graduate students and environmental professionals as they learn to code an ecological model, many for the first time. We were able to categorize and provide examples of the main challenges and obstacles, which fell into three main groups that follow the steps of good modeling practice: problem scoping and conceptualization, formulation, and evaluation. We then provide guidance on how to overcome these obstacles while developing good coding and modeling practices that will result in more scientifically defensible models.