how to write a abm report?

how to write a ABM(agent based modeling) report? （如何撰写ABM的报告？）

first let’s take a look at the parts of ABM report. Here, I’d like to share the OOD framwork to you:
https://www.jasss.org/23/2/7.html Grimm, V. et al. (2020).

We shold know that there is no must for every abm creator to follow this framework. And sometimes it’s too complex for publishing. However, it’s a great way for us to organize our method part in our wirting.

• 1.purpose
• 2.entities, state variables, and scales
• 3.Process overview and scheduling
• 4.design concept
• 5.initialization
• 6.visualization
• 7.input data
• 8.model outputs/simulation experiments
• 9.submodels(several specific fuction)

1.purpose

what we should do in this part?

the aim of modeling.
a simple overview of our abm model

2.entities, state variables, and scales

• a simple introduction of our entities and what entities include, the space scale, the time scale.
• then, describe all the agents: agents’ parametres: agents’ attributes(threshold, uid, find_range, activation weight) / variables: location(geometry), state, observe_num.
• space entities
• schedule
• data collection and register

3.Process overview and scheduling

just interpret how the schedule can be used.

4.design concept

• the objectives of agents（agent的目标是什么）e.g.go out of the maze.
• sensing of agents (agent的感知) describe physical sensing and social network sensing.
• interaction: the interaction among people, the interaction between person agent and physical environment.
• Heterogeneity (异质性): describe the behavior difference in agent decision-making
• Stochasticity: the random initialization and random behavior of agents.
• observation: when data is collected?