PoMM User's Manual: Difference between revisions
| Line 556: | Line 556: | ||
The model features several agent types and the environment itself: | The model features several agent types and the environment itself: | ||
* '''''Citizens''''': | * '''''Citizens''''': | ||
** Characteristics: Possess varying levels of economic capacity (which can be distributed unequally), sentiment towards NBS adoption, memory of recent risk events, susceptibility to social influence from neighbors, and the potential to relocate. They experience risk based on their current location. | ** '''Characteristics:''' Possess varying levels of economic capacity (which can be distributed unequally), sentiment towards NBS adoption, memory of recent risk events, susceptibility to social influence from neighbors, and the potential to relocate. They experience risk based on their current location. | ||
** Decisions/Actions: Regularly update their memory of risk events and adjust their NBS sentiment based on personal experience, memory, and the sentiment of nearby citizens (social influence). If risk exposure remains high and they have sufficient economic capacity, they might move to a less risky area. They can also petition the Public Authority if their perceived risk and memory are high. Citizens are subject to taxation by the Public Authority. | ** '''Decisions/Actions:''' Regularly update their memory of risk events and adjust their NBS sentiment based on personal experience, memory, and the sentiment of nearby citizens (social influence). If risk exposure remains high and they have sufficient economic capacity, they might move to a less risky area. They can also petition the Public Authority if their perceived risk and memory are high. Citizens are subject to taxation by the Public Authority. | ||
*'''''Owners (Residential & Commercial)''''': | |||
** Characteristics: Similar to citizens regarding economic capacity, NBS sentiment, memory, and risk exposure. They are categorized as either "residential" or "commercial". | |||
** Decisions/Actions: Update memory and risk perception. Decide whether to invest in NBS. Residential owners base this decision on their sentiment, affordability (considering economic capacity and taxes), and perceived risk. Commercial owners use a Return on Investment (ROI) calculation, comparing expected damage reduction from NBS against its cost. Wealthier owners might expand their property holdings if their economic capacity stays high for a period. Owners are also subject to taxation. | |||
*'''''Public Authority:''''' | |||
** '''Characteristics:''' A single agent representing the governing body. It manages a budget funded by taxes. Key dynamic attributes include its political alignment (shifting between pro-environment and pro-development stances), the strength of its policies, and its influence. It receives petitions from citizens expressing concern. | |||
** '''Decisions/Actions:''' Periodically (monthly) adjusts its political alignment, policy strength, and influence based on factors like average citizen risk perception, average water contamination levels, the volume of citizen petitions, and its current budget balance. Annually, it sets the taxation rate based on its alignment and policy strength, then collects taxes from citizens and owners. If its budget allows and alignment is favorable, it may offer subsidies to owners in high-risk areas to encourage NBS adoption. | |||
*'''''CEC Monitors:''''' | |||
** '''Characteristics:''' Stationary agents placed within water bodies. They have attributes defining their detection accuracy (related to a 'cost barrier'), their influence strength (for awareness campaigns), and their capacity to directly mitigate pollution. | |||
** '''Decisions/Actions:''' Monitor local water for Contaminants of Emerging Concern (CECs). If high levels are detected, they can directly reduce some contamination based on their capacity. They can also trigger public awareness campaigns (boosting citizen/owner NBS sentiment) when contamination is high, although this effect is rate-limited across all monitors. | |||
* '''''NBS Solutions:''''' | |||
** '''Characteristics:''' Represent specific NBS installations owned by an owner agent. Defined by cost, activation time (time to become effective), mitigation effectiveness (for flood and pollution), maintenance cost, radius of effect, age, and a decay rate representing diminishing effectiveness over time. | |||
** '''Decisions/Actions:''' Once adopted by an owner, they take time to reach full effectiveness. They reduce flood and pollution risk within their designated radius. Their effectiveness decreases over time unless maintained (maintenance is assumed to be funded by the owner, impacting their implicit finances rather than an explicit budget depletion in the model). | |||
When the model has only just been loaded, the grid appears black. '''[Fig. 043]''' | When the model has only just been loaded, the grid appears black. '''[Fig. 043]''' | ||
Revision as of 11:19, 7 April 2025
Module Overview
Purpose of the Policy Making Module
The objective of the Policy-Making Module (PoMM) is to enable users to analyze the impact of changes in the policies related to the adoption of NBS (or hybrid NBS) for mitigation of CECs from urban runoff, hence enabling users on both science and policy sides to devise what changes would be more effective.
In order to link the PoMM to real-world applications, this general objective has been declined into three specific objectives (or Central policy issues, CPIs) that allow decision-makers to explore, in a given context, the best ways
- to include NBSs among customary or preferred solutions in spatial planning;
- to include CECs in water monitoring plans;
- to develop a pilot management plan of CECs from urban runoff that includes NBS solutions.
To make all this possible the PoMM hinges on three pivots:
- Knowledge representation,
- Policy / decision case definition (mapping of case playground),
- Questioning, analysis of the outcomes of modelling/simulations, reporting for decision.
Who is the PoMM intended for
The PoMM is specially conceived for decision-makers and policy-makers who are involved (or might be involved) in the formation of policies and rulemaking about the adoption of NBS for the mitigation of runoff CECs.
Intended users of the PoMM include:
- Policymakers-rulemakers at town, province, regional level
- Bureaucratic and administrative agents (including controlling and permitting bodies)
- Politicians
- Planners
- Scientists.
From the PoMM viewpoint, user categories are not linked to the actual role played by a user in real-life (a user can play any role, real or fictional). Having this in mind, the PoMM is applicable to both actual and potential situations.
Key functionalities
The key functionalities of the PoMM module are described in the following table:
| Submodule/Functionality | Description |
|---|---|
| Knowledge representation | includes the terminology service which assures a common understanding across all PoMM parts, the information stored about the cases under study, and the guidelines for the different types of experiments |
| Policy / decision case definition (mapping of case playground) | includes the tools to describe the case under study in which PoMM experiments take place, to formalize the existing decision-making and policy-making procedures, information flows, and practices following the Business Process Model and Notation (BPMN), and to assign NUTS, NBS and CECs considered. |
| Questioning, analysis and reporting for decision support | includes the tools and interfaces to transform a research question into a PoMM query by designing experiments, then analyzing the outputs obtained. Reporting encompasses the tools to communicate the results in ways suitable for the intended targets. |
How to access the PoMM
You can access the PoMM module via the AI-DSS Platform following general login instructions and pressing the appropriate link on the platform's side menu.
User System / Device requirements
For optimal performance, the following hardware and operating system configurations are recommended:
- Operating System:
- 64-bit Windows 11, macOS Ventura, or latest Linux distributions
- Processor:
- Quad-core CPU (Intel i5/i7 or AMD Ryzen 5+)
- RAM:
- 8 GB or more
- Web Browser:
- Latest version of Chrome or Firefox (for best compatibility and speed)
- Display:
- 1080p (Full HD) or higher resolution
- No installation is needed.
- NetLogo Web does not support all features available in the desktop version of NetLogo. For advanced functionalities, consider installing the desktop version.
When using the PoMM, it is very important that you do not use the back/forward buttons of the browser as you run the risk of compromising your session and having to start over: just use the buttons and links that appear in the interface.
A matter of privacy
After following the link on the platform's side menu to access the module, yor are asked again to accept a specific privacy policy concerning your information and its handling in the PoMM [Fig. 01].

The PoMM does not store user data, including uploaded files, configurations, models, simulations, or reports, beyond the duration of the active session. Once the session ends, all data will be permanently deleted from the platform's servers.
It is your sole responsibility to download and securely save any data, reports, or configurations generated or uploaded during the session. The PoMM is not liable for any loss of data due to failure to download or save session outputs.
While the PoMM platform implements standard security measures to protect active session data, users are advised to avoid uploading sensitive or confidential information.
If you do not agree to the policy conditions, you are redirected to the public area of the Help section of the module.
Strike the right button
The PoMM offers a wide variety of specific features all geared towards making your journey as satisfying and useful as possible.
It is important to strike the right button to start with! [Fig. 02]

- Start New Session: Begin a new policy modelling session from scratch.
- Restore Session: Resume a previously saved modelling session.
- Process templates: Decide your strategy answering some questions to start a new session with a pre-configured process template.
- Agents simulation: Proceed with the Agent Based Simulation.
- Thesaurus & Vocabulary: Access the standardized terminology and definitions.
- Help & User's Guide: Access comprehensive documentation and user guides.
Brief flow of operations
The flow that users follow in the PoMM goes through 5 main steps:
- description of the case under study defining what the starting experimental context looks like with respect to the objectives to investigate (i.e.: to include NBSs among customary or preferred solutions in spatial planning; to include CECs in water monitoring plans; to develop a pilot management plan of CECs from urban runoff that includes NBS solutions)
- definition of an intervention to influence the baseline context in order to facilitate the achievement of one's goal (where should/can I act? how?)
- analysis of the outcomes of the experiment performed (how does the hypothesised intervention change my initial context? what are the results obtained? am I closer to my goal?)
- documentation and sharing of results (how do I document and share the results of my experiment with other interested stakeholders?)
- overcoming doubts and obstacles in experimentation (what tools do I have to deepen and reduce the risk of language ambiguity/equivocality across different knowledge domains and fields of practice involved in my experiment?).
Difference between network modelling and agent based modelling
There are two main modelling approaches in the PoMM:
- a network modelling approach to mapping out the relationships among variables that affect CEC-NBS decisions in a real-world procedural decision-making process to reveal the overall structure of the system, observe how the system behaves without any intervention, define what are the interventions needed to change the final state of the system to own advantage;
- an agent based modelling approach simulating the actions and interactions of individual "agents" (could be different stakeholders but also NBS solutions) within the system to explore what behaviour could emerge as a response to pollution risks, floodings, etc. It's like creating a virtual world where watching how individual behaviors add up to create larger and complex patterns.
By combining them, users can create models that are both cognitively realistic and dynamically rich and this is particularly valuable for studying complex systems, as in the case of the use of NBS solutions to mitigate the pollution effects of CEC contaminants from urban runoff phenomena.
The two modelling methods are managed separately in the PoMM, accessed from two different functions in the main menu that are not interconnected.
Generally speaking, in a logical sense, the networking modelling takes place ‘before’ the agent based modelling.
That's because the network modelling approach provide the "cognitive" framework, the understanding of how factors interrelate and helps to decide where to intervene.
The ABM approach provides the "behavioral" framework, the simulation of how agents act, and allows to explore and compare the sentiment and social response to NBS for CECs depending on factors like front and maintenance cost, risk-mitigating capacity, etc.
In PoMM you can choose which modelling system you want to use: you can use both if you want to get the best out of your analysis.
But you can also decide to use only one because you consider it more suitable for the type of reflections you are making.
Furthermore, both modelling techniques allow you to choose your own approach: are you interested in a purely descriptive or observational approach to gain a better understanding? Or are you interested in an approach that involves intervening on what you are observing and understanding the effects of your intervention? Are you interested in evaluating the impact of any changes following your intervention hypotheses? And from what point of view?
The PoMM allows you to do all this: read the following suggestions and user instructions very carefully to find your winning strategy!
Knowledge representation
The first pivot of the PoMM module is knowledge representation.
Activities like CEC characterization, NBS classification, policy-making guidelines intersect on the same case from different perspectives and with diverse vocabularies.
Sometimes the meaning of important terms that we use are confusing (multiple meanings depending on context or user, or synonyms) or a term is authoritatively defined somewhere, but its definition does not fit well with our shared domain.
We aimed to create clear, machine-readable definitions for key terms, establishing logical connections within the PoMM framework and simulations. This minimizes misunderstandings caused by differing interpretations of language across the various fields involved in D4Runoff.
Terminology (vocabulary, thesaurus and ontology)
The D4Runoff Thesaurs is a controlled and structured vocabulary, related to the domain the project deals with in, which concepts are represented by terms, organized so that relationships between concepts are made explicit.
The D4RUNOFF Thesaurus:

- Ensures everyone understands the information structure (common meaning).
- Clearly states the assumptions made about the subject.
- Checks that the subject information is consistent (verifies accuracy).
- Allows the subject information to be used again in different ways.
- Separates subject knowledge from how it's used.
- Simplifies searches and makes it easier to find information.
You can access the Thesaurus by simply clicking on the button on the main menu: a new browser window will open, allowing you to have the main definitions at your fingertips so that you can better understand how to design your case study [Fig. 03].
You do not need to authenticate to the Thesaurus if you are already logged in to the platform.

What you can do
The use of the vocabulary/thesaurus is very intuitive.
On the main page [Fig. 04] you can find:
- a bar on which to write the term you want to search for
- an alphabetical list on which you can click to search
- a list of main contents at your immediate disposal that help you understand some of the most relevant elements which represent the scope of analysis of the PoMM or are useful for your experiments
- a link to an advanced search.

Fig. 05 - Example of a concept of the Thesaurus and its relationship
Note that the "My Account link" on the navigating bar is only available to system administrators.
The interface [Fig. 05] allows you to:
- see the description of each search term
- read definitions and bibliographical notes
- directly access other terms related to the entry you searched with more specific, broader, equivalent, preferred or semantically related meaning.
Note that the interface is multilingual but the contents are in English.
In the same screen of a defined term, different kinds of relationships are displayed allowing you to move easily from one term to another via the different links.

There are different kind of relationships you can find in the D4Runoff thesaurus that can include:
- hierarchical relationships such as broader term (BT) and narrower term (NT). These terms denote relationships between the concepts (not the terms) and indicate whether a concept contains or is contained by another concept. Hierarchical relationships can be used to broaden and narrow a search effectively and ensure that narrower terms fall within the scope of the broader terms;
- equivalence relationships such USE and UF (Use For). They are used to denote equivalence between terms (not concepts) and to distinguish between preferred terms and their synonyms (a term, which has the same meaning or covers the same concept as another term or multiple terms) or quasi-synonyms (a term that does not usually have the same meaning as the preferred term but does in the context of a specific thesaurus) [Fig. 06];
- associative relationships such as related terms (RTs). They are used to indicate that different terms in a thesaurus are related in some way or have an overlapping scope. They thus allow users to expand their initial search into different aspects of the subject.

The advanced search [Fig. 07] allows you to navigate the Thesaurus also, for example, from the notes that have been associated with each term, doing your own free search.

The Thesaurus is linked to qualified sources and validated vocabularies
- EUROVOC: a multilingual thesaurus (controlled vocabulary) maintained by the Publications Office of the European Union, used by the European Parliament, the Publications Office of the European Union, the national and regional parliaments in Europe, some national government departments, and other European organisations [Fig. 08]
- AGROVOC: a multilingual controlled vocabulary covering all areas of interest of the Food and Agriculture Organization of the United Nations (FAO), including food, nutrition, agriculture, fisheries, forestry and the environment.
- GEMET - GEneral Multilingual Environmental Thesaurus: a source of common and relevant terminology used under the ever-growing environmental agenda that has been developed since 1995 as an indexing, retrieval and control tool for the European Topic Centre on Catalogue of Data Sources (ETC/CDS) and the European Environment Agency (EEA), Copenhagen.
- EARTh - Environmental Applications Reference Thesaurus: represents a general- purpose thesaurus for the environment. It promises to become a core tool for indexing and discovering environmental resources by refining and extending GEMET.
Knowledge repository
The PoMM knowledge repository (help, user's manuals, technical documentation) has been organised as a semantic-rich website.
It was developed on the basis of the Mediawiki platform, an extremely powerful and scalable software, which enables the implementation of feature-rich wikis and allows you to move freely between contents depending on your qualification as a user. [Fig. 09]
What you can do
On the main page, you can access the main content and information.

From this page it is possible to reach every area of the help feature.
If you are a registered user (from the AI platform), you can access a restricted area that contains the Comprehensive Knowledge Base and Full Documentation and allows to:
- access the FAQ system and specific tutorials
- analyse case studies (including D4Runoff pilot sites) and applications of the PoMM in other contexts
- deepen the policy scenario
- deepen the underlying principles, mechanisms, and technology choices incorporating the theoretical body of knowledge that supports PoMM operations
- access targeted bibliographies and other useful resources
- access technical documentation about the technology, architecture, core modules and interconnections.
Policy / decision case definition
In the PoMM, you build policy scenarios to map out the steps involved in making decisions that affect well focused central issues in order to operationalise the exploration, design and analysis of changes in the policies related to the adoption of NBS for mitigation of CECs from urban runoff.
Upstream of the activities for which the platform can offer support in your thinking, you should start by formulating your "research question" and keep it in mind all along the way: what are you trying to answer? What do you want to explore?
This step is fundamental to the entire PoMM process, serving as its core and ensuring the coherence and consistency of experiments and results.
Just to give you an idea of the type of questions on which you would like to reflect...:
- How can municipal procurement regulations be amended to effectively integrate Nature-Based Solutions (NBS) into the terms of reference for urban planning and design tenders?
- Within the existing municipal regulatory framework, which department—urban planning or public works—offers the most effective point of intervention for promoting NBS adoption in routine roadside renovations?
- Given the current regional legal framework, at what stage in the decision-making process would political advocacy be most impactful in securing a bill that mandates a recurring budget for CECs monitoring?
- Which office holds the greatest influence in obstructing regulations aimed at making CECs management plans mandatory?
- Which proposed NBS regulation, “A” or “B,” will have better impact and be more viable?
- Considering the current regional legal framework, where within the decision-making hierarchy should political pressure be applied to successfully delegate runoff management to water utilities?
- ....
As you can easily imagine, all these questions bring with them the initial need to understand the boundaries of your system and how things work today in your context.
Essentially, it's a way to visualize "your world" in relation to the relevant policy-making cases as it is, to create the ‘laboratory’ of the experiment and to map the framework of the case under study.

Typically, the definition of the policy/decision case starts with network modelling.
Procedural description (network modelling) of the case
To outline your case you have to start a new session from scratch.
From the main menu choose |Start new session| [Fig. 010]
Outline the case under study
You will need to outline your case study by following the steps below.
(1) Defining the geographic boundaries of your physical system
Your context will change radically if you are involved in analysing policies acting at different territorial levels: the policy processes or stakeholders to be involved may also change greatly. The PoMM allows you to keep track of the territorial level at which you are reasoning.
(2) Select the targeted Natural based solution
The same reflection made for the territorial dimension applies to the type of NBS solution you are investigating: again, not all solutions act on all territorial levels or require same implementation or regulatory processes. Also in this case the PoMM allows you to keep track of this in your simulation even though in this case the identification and evaluation of the NBS should have already been developed in other sections of the AI platform that are dedicated to this purpose.
(3) Choose the targeted Contaminants of emerging concern (CEC)
The contaminants you are investigating are also related both to the NBS solutions you have chosen and to specific problems that equally may have to be considered in very different policy making processes. Again, the PoMM allows you to keep track of them in your simulation of the CECs you have identified. As with NBSs, the identification of targeted CECs should already have been developed in other sections of the AI platform that are dedicated to this very purpose.

The system allows you to keep a note of the choices you have made, possibly adding your comments so as to have a written trace that will feed the reporting of your experiment. [Fig. 022]
You can also leave the proposed text unchanged in the dialogue box that appears but we suggest you that you use these spaces to make your notes.
The activity of modelling decision making processes and scenario setting is a complex activity that may also require interactions and comparisons between different actors. By doing so, you do not risk losing valuable information.
With this first three steps you have completed the Unity of analysis definition (NUTS, NBS & CEC)
To proceed to the next stage of your case study baseline press |Next|.
(4) Define the actual (current) decision workflow diagram
To be able to intervene in a decision-making process and understand where and how, it is necessary to describe it.
(5) Identify the most important entities for the decision workflow
Once you have defined in the previous step the decision-making process involved as it currently is and having identified some entities to analyse and their variables, you will have to go through the last mile of this phase in order to have your first baseline report.
This involves selecting the variables that you defined in the BPMN in the form of annotations and that will be shown in an interface where you can decide which ones will be analysed in the simulation.
Note that if you haven't inserted any variables in your BPMN (in the form of an annotation) you won't be able to select any nodes and therefore won't be able to proceed with the simulation proposed by the PoMM.
Bottom-up modelling (agent based) of the case
Outiline the case for ABM exploration

The Agent simulation is a separate feature of the PoMM module, powered on netLogo Web application, which you can access through the main menu. [Fig. 042]
In this case, your interface will directly load a basic simulation model. This model was prepared as part of the D4Runoff project for the PoMM module.

This is an agent-based model simulating the adoption dynamics of NBS within an urban environment. It explores how citizens, property owners, and a dynamic public authority interact under risks from flooding and CECs pollution in urban runoff. The model focuses particularly on how different conditions and policy choices influence NBS uptake and its subsequent impact on mitigating pollution. It invites users to test scenarios and reflect on QUESTIONS like:
- How do people respond to environmental risk?
- What role does public policy play in driving or hindering adaptation?
- Who benefits - and who might be left behind?
The model features realistic actors: citizens and property owners (both residential and commercial), a dynamic Public Authority, and environmental monitors. Each actor reacts to events like floods or pollution, but their responses depend on their economic means, experience, and social surroundings. For example, wealthier property owners may adopt NBS more readily, while citizens in risk-prone areas may petition the government or choose to relocate. This raises QUESTIONS:
- Are current policy tools equitable?
- Do incentives and taxes encourage resilience in vulnerable areas?
Set in a virtual city represented by a spatial grid, the model takes into account how elevation, proximity to water, and stochastic environmental events shape local risk. Users can adjust a range of parameters - from the frequency and intensity of floods to the distribution of economic capacity among residents. This flexibility helps explore QUESTIONS such as:
- How might more frequent extreme events alter risk perception?
- What happens when economic inequality increases?
- How sensitive should policies be to citizen pressure or environmental monitoring data?
Each simulated time period unfolds with agents updating their behaviors, supporting (or opposing) NBS, and influencing the environment. The Public Authority responds to trends over time - adjusting policies, budgets, and political orientation. The model helps users uncover the unintended consequences and feedback loops inherent in urban systems, suggesting relevant QUESTIONS like:
- If NBS are adopted mainly in wealthier zones, could this shift risk elsewhere?
- Does awareness-raising lead to meaningful action?
- What are the long-term outcomes of shifting between pro-environment and pro-development stances?
Outputs include intuitive visuals and graphs tracking key indicators like risk exposure, public sentiment toward NBS, environmental quality, and NBS adoption. These help planners and policymakers trace the impact of their hypothesized decisions over time and evaluate trade-offs. The model is not meant to provide definitive answers - it is a space for reflection and testing, guiding users to ask sharper, more targeted questions about resilience, equity, and the governance of urban environmental risks and NBS policies.
The interface is a console from which all the necessary simulations can be carried out using a series of elements already present.
Assumptions and Limitations of the default model
Simplifications:
- The economic system uses an abstract 'capacity' metric; costs and benefits are relative.
- Social influence is modeled based on spatial proximity, not complex social networks.
- NBS are represented generically, without differentiating specific types or detailed ecological functions beyond risk reduction percentages.
- Public Authority decision-making follows programmed rules based on specific inputs, simplifying real-world political complexities.
- Agent behavior is rule-based and driven by defined thresholds and calculations.
- The spatial environment uses a regular grid, and risk propagation is based on simplified distance/elevation functions.
Limitations:
- The model doesn't include detailed representations of other urban infrastructure (e.g., grey infrastructure like drainage systems).
- Agent diversity is limited to the defined attributes; factors like age, education, or detailed psychological profiles are not included.
- The financial impact of NBS maintenance on owners is implicit (via decay) rather than explicitly modeled as an ongoing cost affecting their capacity.
- The model is largely closed; it doesn't account for external shocks like major economic changes or technological breakthroughs not represented by the stochastic events.
- The specific mathematical distributions used for event frequency (Poisson) and intensity (Log-Normal) are assumptions about the nature of these hazards.
Loading models from the PoMM library or from your own library
In addition to the default model that is loaded when you access this section of the PoMM, you can also load other models available in the library, or models that you have saved on your repositories.
The models in the library may be variants with a different interface (for example, different output variables may be plotted) or have different hard-wired values (parameters set directly in the code).
For this reason it is always important to read the documentation available in the Model Info tab.
Also remember that the model code is always visible, so you can check or change the model according to your needs.
Before starting: How the default model works
Simulated System:the default model operates on a 2D grid representing a stylized urban area featuring land and water zones. This area is populated by citizens and property owners who face periodic flood and pollution events. The model incorporates the decision-making process for adopting NBS, the effectiveness of these solutions, the role of environmental monitoring (specifically for CECs), and the dynamic nature of a public authority whose policies adapt based on environmental conditions and public sentiment.
1. Key Agents and Their Behaviors The model features several agent types and the environment itself:
- Citizens:
- Characteristics: Possess varying levels of economic capacity (which can be distributed unequally), sentiment towards NBS adoption, memory of recent risk events, susceptibility to social influence from neighbors, and the potential to relocate. They experience risk based on their current location.
- Decisions/Actions: Regularly update their memory of risk events and adjust their NBS sentiment based on personal experience, memory, and the sentiment of nearby citizens (social influence). If risk exposure remains high and they have sufficient economic capacity, they might move to a less risky area. They can also petition the Public Authority if their perceived risk and memory are high. Citizens are subject to taxation by the Public Authority.
- Owners (Residential & Commercial):
- Characteristics: Similar to citizens regarding economic capacity, NBS sentiment, memory, and risk exposure. They are categorized as either "residential" or "commercial".
- Decisions/Actions: Update memory and risk perception. Decide whether to invest in NBS. Residential owners base this decision on their sentiment, affordability (considering economic capacity and taxes), and perceived risk. Commercial owners use a Return on Investment (ROI) calculation, comparing expected damage reduction from NBS against its cost. Wealthier owners might expand their property holdings if their economic capacity stays high for a period. Owners are also subject to taxation.
- Public Authority:
- Characteristics: A single agent representing the governing body. It manages a budget funded by taxes. Key dynamic attributes include its political alignment (shifting between pro-environment and pro-development stances), the strength of its policies, and its influence. It receives petitions from citizens expressing concern.
- Decisions/Actions: Periodically (monthly) adjusts its political alignment, policy strength, and influence based on factors like average citizen risk perception, average water contamination levels, the volume of citizen petitions, and its current budget balance. Annually, it sets the taxation rate based on its alignment and policy strength, then collects taxes from citizens and owners. If its budget allows and alignment is favorable, it may offer subsidies to owners in high-risk areas to encourage NBS adoption.
- CEC Monitors:
- Characteristics: Stationary agents placed within water bodies. They have attributes defining their detection accuracy (related to a 'cost barrier'), their influence strength (for awareness campaigns), and their capacity to directly mitigate pollution.
- Decisions/Actions: Monitor local water for Contaminants of Emerging Concern (CECs). If high levels are detected, they can directly reduce some contamination based on their capacity. They can also trigger public awareness campaigns (boosting citizen/owner NBS sentiment) when contamination is high, although this effect is rate-limited across all monitors.
- NBS Solutions:
- Characteristics: Represent specific NBS installations owned by an owner agent. Defined by cost, activation time (time to become effective), mitigation effectiveness (for flood and pollution), maintenance cost, radius of effect, age, and a decay rate representing diminishing effectiveness over time.
- Decisions/Actions: Once adopted by an owner, they take time to reach full effectiveness. They reduce flood and pollution risk within their designated radius. Their effectiveness decreases over time unless maintained (maintenance is assumed to be funded by the owner, impacting their implicit finances rather than an explicit budget depletion in the model).
When the model has only just been loaded, the grid appears black. [Fig. 043]
1. Environmental Events: Stochastic flood and pollution events occur based on user-defined frequencies and intensities. Events increase risk locally on affected patches and add to the memory of agents present. Pollution events also directly increase CEC contamination in water bodies.
2. Agents:
- Citizens & Owners: Perceive risk based on local patch conditions, mitigation from nearby NBS, and proximity to water. They maintain a decaying memory of past risk events. Their sentiment towards NBS adoption evolves based on: Positive Boost: A city-wide, non-cumulative boost occurs once per day if any CEC monitor detects high contamination (>0.5). Negative Feedback: Sentiment decreases slightly if the average city-wide CEC contamination remains below a threshold (hardcoded: 0.15) for a sustained period (hardcoded: 30 days). Social Influence: Weekly adjustments based on the average sentiment of nearby agents.
- Decision Making: Citizens may petition the Public Authority (PA) if memory and risk are high, and may relocate if risk is persistently high and they have economic capacity. Owners decide whether to adopt NBS based on their type: Residential: Considers sentiment, risk, NBS cost, and economic capacity (adjusted for tax burden). Commercial: Calculates Return on Investment (ROI) based on risk reduction potential vs. NBS cost.
- NBS: Created by owners upon adoption. Attributes (cost, mitigation power, radius) depend on the owner's risk level at the time of adoption. NBS reduce local risk as they become effective, but their effectiveness can decay over time.
- CEC Monitors: Located in water bodies, they can directly mitigate very high local CEC levels (>0.7) and trigger the city-wide positive sentiment boost (>0.5).
- Public Authority (PA): Dynamics (Monthly): Its
political-alignment(pro-environment vs. pro-development),policy-strength, andinfluence-strengthare updated based on average risk, average CEC, petition count, its own budget, and user-set sensitivity parameters (sliders). Higher pressure/pollution tends to push alignment towards pro-environment (+1), influencing policy strength and tax rates. Actions (Annual/Ongoing): Collects taxes (rate influenced by alignment/policy strength; agent contribution based on economic capacity and risk exposure), adjusts its budget, probabilistically offers subsidies for NBS adoption to high-risk owners if budget allows.
3. Key Feedbacks: The model includes loops such as: Risk -> Sentiment/Petitions -> PA Dynamics -> Taxes/Subsidies -> Agent Economics -> NBS Adoption -> Risk Mitigation. Also: Pollution -> Monitor Detection -> Sentiment Boost/Drop -> Adoption -> Mitigation -> Pollution. How to use it
How to use it
Interface Controls:

Sliders: [Fig. 043]
flood-frequency-slider,pollution-frequency-slider: Control the daily probability of flood/pollution events.flood-intensity-mean-slider,pollution-intensity-mean-slider: Set the average intensity for events.flood-intensity-sd-slider,pollution-intensity-sd-slider: Set the standard deviation for event intensity.num-citizens-slider,num-owners-slider,num-cec-monitors-slider: Set the initial number of these agents.pressure-sensitivity-slider: Controls how strongly citizen pressure (risk, petitions) influences PA political alignment.env-sensitivity-slider: Controls how strongly the average CEC level directly influences PA political alignment.budget-influence-on-policy-slider: Controls how much the PA's budget constrains its potential policy strength.
Switches: [Fig. 043]
inequality-distribution: Toggles initial economic capacity distribution between 'Equal' (off, random uniform) and 'Pareto-like' (on, 20% high/80% low capacity).

Buttons: [Fig. 044]
setup: Initializes the model based on current interface settings. Clears previous runs.go: Runs the simulation for one step (one day).go-forever: Runs the simulation continuously until stopped.

Monitors: [Fig. 045]
total-nbs-adopted-monitor: Current count of active NBS solutions.avg-risk-exposure-monitor: Average risk perceived by citizens and owners.avg-nbs-sentiment-monitor: Average NBS adoption sentiment across citizens and owners.avg-cec-contamination-monitor: Average CEC level across all water bodies.- (Optional monitors can be added for PA dynamic attributes)

Plots:
Plots: [Fig. 046]
risk-exposure-plot: Average risk exposure over time.nbs-sentiment-plot: Average NBS sentiment over time.cec-contamination-plot: Average CEC contamination over time.pa-attributes-plot: Tracks PA's dynamic attributes (influence-strength,policy-strength,public-budget,taxation-rate). Ensure pens named "influence", "policy", "budget", "taxation" exist.
View: [Fig. 047]

- Patches show water (blue, darker = higher CEC), land (green, darker = higher elevation), initial risk zones, agent risk (gradient green->orange->red), or NBS presence (yellow).
- Agents have distinct shapes (
person,house,square,building,plant). Size can indicate attributes like economic capacity or effectiveness.
You can see the view in the black window when you push the |set up| button.
Warning: Always check the |Info section| to be sure you are aware of the last version set-up of the proposed model.
You will need to outline the case for ABM exploration by following the steps below, starting with the ABM modelling set-up.
(1) Set up the ABM model
The set-up is very simple in this case because you have only to press the corresponding button |set up| [Fig. 048] on the left side of the console under the sliders.
(2) Run the baseline configuration
The model must be run to see how, over a given period, the values of the parameters set by default produce a series of effects.
This means that you are not currently “intervening” in the model (you are not changing the set parameters) but first trying to understand how it evolves in the absence of any intervention.
Please note that an extensive documentation about NetLogo and its features is at your disposal selecting the |About NetLogo| in the menu bar on the top of the application.
Questioning, analysis and reporting for decision support
The Questioning, analysis and reporting for DSS functions constitute the actual experimentation phase of the PoMM.
The experiments are implemented via ad-hoc programs libraries and models tailored for the purpose to assess the impact of the policy change examined in relation to the D4Runoff central policy issues (CPIs).
The objective is to allow Users to transform a policy-making research question (relevant to the CPIs) into a PoMM query by designing experiments, then analyzing, comparing and finally reporting the results obtained.
Implementation of policy and decision-making experiments (procedural view)
This phase is sequential to the Outline the case under study (see par. 3.1.1) and goes through the steps of design and run the experiments and to analyze their output.
Design the experiment(s)
In the last step of previous point (5) Identify the most important entities for the decision workflow , after the BPMN diagramming and the choice of the entities for your experiment, you downloaded the Intermediate Report and the back-up files to be allowed to the next step.
Run the experiment(s)
Once your experiment has been set up you can start your simulations.
Analyze the output of the experiment(s)
The last step of the FCM analysis is the verification of the outcome of your experiment. What has changed in your scenario? Did you achieve the expected objective?
| In the next screen you will see the result of the simulation after the intervention you have planned. [Fig. 069]
On the left you'll find the table that represents the state of equilibrium reached by your system after the intervention. The first column shows the initial variables of your system. The second column shows the baseline values. The third column shows the effectiveness that your intervention had on each of the variables, including the one you are observing. In this case we can see that your intervention had a positive effect on the observed variable (‘Regulatory Adoption Rate Driven by cost-benefit analysis’), which increased from 0.52 to 0.56. In the table on the left, the values are shown as a percentage. Your intervention produced an increase of almost 9.5%, bu had a significant effect on the directly connected elements linked to the activity promoted among the stakeholders. |
|
Implementation of policy and decision making experiments (agent based view)
Running ABM experiments: good practices When running an ABM experiment, you should consider the following guidelines.
Define the objective of your experiment. First, decide what you want to get out of the experiment. For example, you might want to find out how the number of owners affects how people feel about NBS-prone policies.
State your hypothesis. Next, state what you think will happen (for example, that having more owners will lead to more people supporting and using NBS solutions).
Establish your observables. Then, you need to establish what you're going to observe, i.e. the key output indicators. For example, you might want to know the total number of NBS adopted, the average sentiment towards NBS, the average CEC contamination and the average risk exposure.
Set your baseline scenario. Set your starting point (baseline) and run the model multiple times. e.g. 10-20 runs.
Set your intervention scenario. Then set your intervention scenario, and run the model as many times as the baseline scenario.
Analysis. Compare the average trends and final states of the output indicators between the baseline and intervention groups. You may want to use statistical tests (like t-tests or ANOVA on final values or average values over a period) if appropriate, given the multiple runs, to determine if differences are significant. Look at the distribution of key indicators (e.g. does the increased proportion of owner-residents also increase support for NBS policies?).
Documenting and reporting policy and decision-making experiments
Report the findings
Reporting encompasses the tools to communicate the results in ways suitable for the intended targets.


















































