|
|
| Line 28: |
Line 28: |
| Dissemination Level: PU | | Dissemination Level: PU |
|
| |
|
| ==== PoMM User’s Manual ====
| |
|
| |
| ==== 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 and 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 is grounded into three specific objectives enabling 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 hybrid 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 hNBS for the mitigation of runoff CECs.
| |
|
| |
| Intended users of the PoMM include
| |
|
| |
| * Policymakers-rulemakers at town, province, regional level
| |
| * Bureaucratic and administrative agents (includng 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:
| |
| {| class="wikitable"
| |
| |+ Table 5 Main submodules/functionalities of the policy-making module.
| |
| |-
| |
| ! 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 the set of CECs and hNBSs 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.
| |
|
| |
| <!-- PSA to be reviewed -->User System / Device requirements [TO BE REVIEWED]
| |
|
| |
| ====== 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'''].
| |
| [[File:001.png|alt=Fig. 01 - PoMM Privacy Disclaimer Acceptance|thumb|Fig. 01 - PoMM Privacy Disclaimer Acceptance]]
| |
| 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. KLINK SRL 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 areredirected to the public area of the Help section of the module.
| |
|
| |
| ====== Strike the right button ======
| |
| The module 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''']
| |
| [[File:Fig. 02 - PoMM Section overview.png|alt=Fig. 02 - PoMM Section overview|thumb|Fig. 02 - PoMM Section overview]]
| |
| * '''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 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 hybrid 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 PoMM:
| |
|
| |
| * a network modelling approach used 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 network modelling approach provide the "cognitive" framework, the understanding of how factors interrelate and helps to understand 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.
| |
|
| |
| === Knowledge representation ===
| |
| The first pivot of the PoMM module is knowledge representation.
| |
|
| |
| 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.
| |
|
| |
| 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.
| |
|
| |
| ==== 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: [[File:003 - Thesaurus & Vocabulary button.png|alt=Fig. 03 - Click Thesaurus & Vocabulary|thumb|Fig. 03 - Click Thesaurus & Vocabulary]]
| |
| * 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'''].
| |
| ===== What you can do =====
| |
| The use of the vocabulary/thesaurus is very intuitive.
| |
| [[File:004 - Thesaurus & Vocabulary Home page.png|alt=004 - Thesaurus & Vocabulary Home page|thumb|Fig. 04 - Thesaurus & Vocabulary Home page]]
| |
| 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 PoMM or are useful for your experiments
| |
| * a link to an advanced search.
| |
| ''Note that the "My Account link" on the navigating bar is only available to system administrators and not to users.''
| |
| [[File:005.png|alt=Fig. 05 - Example of a concept and its relationship|thumb|Fig. 05 - Example of a concept of the Thesaurus and its relationship ]]
| |
|
| |
|
| |
| The interface 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 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:
| |
|
| |
| [[File:006.png|alt=Fig. 06 - Example of equivalent and associative relationships|thumb|Fig. 06 - Example of equivalent and associative relationships]]
| |
| 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);
| |
| # ''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
| |
|
| |
| [[File:007.png|alt=Fig. 07 - Thesaurus Advanced Search|thumb|Fig. 07 - Thesaurus Advanced Search]]
| |
|
| |
|
| |
|
| |
| The advanced search allows you to navigate the Thesaurus also, for example, from the notes that have been associated with each term, doing your own free search.
| |
| [[File:008.png|alt=Fig. 08 - Thesaurus connection with external channels (EUROVOC)|thumb|Fig. 08 - Thesaurus connection with external channels (EUROVOC)]]
| |
|
| |
|
| |
|
| |
| 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
| |
|
| |
| *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 (Help, guides, documents and templates) ====
| |
|
| |
| === Policy / decision case definition ===
| |
|
| |
| ===== Procedural description of the case =====
| |
|
| |
| ===== Bottom-up modelling (agent based) of the case =====
| |
|
| |
| === Questioning, analysis and reporting for decision support ===
| |
|
| |
| ==== Implementation of policy and decision-making experiments (procedural view) ====
| |
|
| |
| ==== Documenting and reporting policy and decision-making experiments (procedural view) ====
| |
|
| |
| ==== Implementation of policy and decision making experiments (agent based view) ====
| |
|
| |
| ==== Documenting and reporting policy and decision-making experiments (agent based view) ====
| |
|
| |
| == User Guide Extended SEN version ==
| |
| === [[Overview of the PoMM in D4Runoff|More about the PoMM and D4Runoff]] === | | === [[Overview of the PoMM in D4Runoff|More about the PoMM and D4Runoff]] === |
| This chapter offers an overview of the D4RUNOFF project and the role of the decision support platform within it. | | This chapter offers an overview of the D4RUNOFF project and the role of the decision support platform within it. |
This is the documentation hub of the PoMM Module of the. Here you can find manuals, information on where to find tutorials and how to use them, and theoretical and general information regarding the use of the ĸ-SDSS.
The D4Runoff project
Urban water runoff plays a role in the deterioration of the quality of surface water, so finding ways to prevent and manage diffuse pollution is key.
D4RUNOFF overall goal is to create create a new framework for prevention and management through the data-driven design of hybrid nature-based solutions for current and future risk scenarios. Its approach will benefit urban planners, water utilities and policy makers. By defining urban runoff and stormwater management plans, the project will help optimise the quality of water that flows into bodies of water.
(Consult the D4Runoff official website for more information about the project)
The PoMM in the AI-Assisted urban runoff management platform
This documentation is provided by KlinK within the scope of the D4Runoff project and is intended to help D4R partners and users in the use and improvement of the policy making module PoMM.
If you already know what to do, you can access the [Policy Making Module PoMM].
Otherwise, please keep on reading.
The knowledge base and user's documentation is organized in the following sections.
PoMM Documentation
PoMM User's Manual
For those short of time, the Five Minutes Guide to the PoMM offers a quick-start tutorial and essential instructions to help users navigate and utilize the k-SDSS.
If you are planning to get the most out of the PoMM, the PoMM User's Manual contains detailed information on the PoMM approach, its application, and best practice. Following this guidance you will understand and successfully utilise the system.
Using and contributing to this place
This documentation hub is based on the Mediawiki software. Consult the Mediawiki User's Guide for information on using it.
Dissemination Level: PU
This chapter offers an overview of the D4RUNOFF project and the role of the decision support platform within it.
This chapter briefly describes the steps to start using PoMM.
This chapter outline the PoMM core functionalities, highlight how the system may aid policymakers by providing exploratory insights, how it may help to streamlining CEC-NBS decision-making, and how the system may enhance collaboration.
This chapter covers essential workflows options when setting-up and interpretating CEC-NBS experiments related to policy analysis and decision-making.
The Case Study Lab is where the main experimentation processs takes place. This chapter provides a guide on how to set-up and make experiments effectively. It serves as a practical manual for users, equipping them with the necessary tools to configure, document, and execute PoM experiments to support interventions on policy making efficiently.
This chapter provides a guide on how to set-up and make PoM experiments based on Agent Based Modelling and simulation (ABM) effectively. The ABM component of the PoMM D4RUNOFF aims to help the assessment of viability and sustainability of policy changes (related to NBS and CECs) through scenario generation.
Though it is part of the Case Study Lab, the ABM simulator is used at a later stage, when potential interventions have already been chosen and you want to explore scenarios of their acceptability.
This chapter describes how to use the Thesaurus and Vocabulary tool within the PoMM. The PoMM Controlled Vocabulary facilitates the retrieval sharing of agreed meanings across the project's disciplines by ensuring consistent terminology, reducing ambiguity, and enabling effective communication and interoperability between diverse stakeholders. Thanks to the Thesaurus, terms are then organised in a structured list of related terms showing synonyms, hierarchies, and associations.
Help
This section is intended as quick help when working with the PoMM Lab application, from where help requests link here.
Content regards the functions New Session, Restore Session, working with Process Templates, Thesaurus & Vocabulary, Ontology Viewer and Agents Simulation.
Here PoMM Users find a collection of common questions and answers about a specific topics, designed to provide quick and helpful information.
This section contains step-by-step instructional guides designed to explain PoMM tasks, concepts and processes through structured explanations and examples.
Who to contat when.
Case Studies and Applications
Using the PoMM at the pilot sites
This section includes BPMN Process Descriptions, ABM Models and Full Experiments provided by Users.
This section provides technical information about the technology, architecture, core modules and interconnections, Data Interchange and LOD, Download, Upload and Backup, Users roles, permissions and access levels
This section explains the underlying principles, mechanisms, and technology choices incorporating the theoretical body of knowledge that supports PoMM operation, to provide a deeper understanding of how and why it works.
References, Data Sources and Other Web Resources
Site development notes (temporary)
D4RDocPack ToDo, tickets and hints
Consult the User's Guide for information on using the wiki software.