|
|
| (55 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| [[File:D4R EU PoMM KlinK Header MainPage.png|frameless|upright=3|d4r header]]
| | This is the documentation hub of the PoMM Module of the AI-Assisted urban runoff management platform of the D4Runoff project. |
| <br><br>
| |
| The D4Runoff project has received funding from the European Union’s Horizon Europe research and innovation programme. Grant agreement 101060638. You may find more information about the project at its [https://www.d4runoff.eu official website.]
| |
|
| |
|
| Here you will find an organised collection of knowledge about the PoMM made available to the D4Runoff partners and users. | | 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 PoMM. |
| | '''To access all the features of these MediaWiki pages of the D4Runoff Project, please request authorisation. |
| | Simply send an e-mail to the following address: [mailto:d4runoff-mediawiki@klink.it d4runoff-mediawiki@klink.it]. Your credentials will be sent within 48 hours.''' |
|
| |
|
| This documentation is provided by [https://www.klink.it 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.
| | == 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. |
|
| |
|
| If you already know what to do, you can access the [http://136.144.235.36:5000/ Policy Making Module PoMM].
| | 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. |
|
| |
|
| Otherwise, please keep on reading.
| | (Consult the [https://www.d4runoff.eu D4Runoff official website] for more information about the project) |
|
| |
|
| The knowledge base and user's documentation is organized in the following sections. | | == The PoMM in the AI-Assisted urban runoff management platform == |
| | |
| == User's Guide PUB version ==
| |
| | |
| === 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. | | 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 that apply to the D4RUNOFF pilots and the foreseen replication cases.
| | == PoMM Documentation == |
| | | This documentation is provided by [https://www.klink.it 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. |
| These specific objectives regard 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.
| |
| | |
| The PoMM hinges on three pivots:
| |
| | |
| * Knowledge representation,
| |
| * Policy / decision case definition (mapping of case playground),
| |
| * Questioning, analysis of the outcomes of modelling and 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 any role, real or fictional). Having this in mind, the PoMM is applicable to both actual and potential situations.
| |
| | |
| ==== Key functionalities ====
| |
| {| 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
| |
| |-
| |
| | 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 ====
| |
| A matter of privacy
| |
| | |
| Data not stored
| |
| | |
| Strike the right button
| |
| | |
| Brief flow of operations
| |
| | |
| Difference between network modelling and agent based modelling
| |
| | |
| === Knowledge representation ===
| |
| ''short intro''
| |
| | |
| ==== Terminology (vocabulary, thesaurus and ontology) ====
| |
| | |
| ==== 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]] ===
| |
| This chapter offers an overview of the D4RUNOFF project and the role of the decision support platform within it.
| |
| | |
| === [[Getting Started|Getting Started]] ===
| |
| This chapter briefly describes the steps to start using PoMM.
| |
| | |
| === [[Features Overview|Features Overview]] ===
| |
| 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.
| |
| | |
| === [[Workflow of the policy-making experiment|Workflow of a PoM experiment]] ===
| |
| 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|The Case Study Lab]] ===
| |
| 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.
| |
| | |
| === [[Modelling and Simulation with Agents (ABM)|Modelling and Simulation with Agents (ABM)]] ===
| |
| 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.
| |
| | |
| === [[Thesaurus and Controlled Vocabulary|Thesaurus and Controlled Vocabulary (TheVoc)]] ===
| |
| 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.
| |
| | |
| [[Category:Help PoMM]]
| |
| | |
| == [[FAQ (Frequently Asked Questions)|FAQ]] ==
| |
| Here PoMM Users find a collection of common questions and answers about a specific topics, designed to provide quick and helpful information.
| |
| | |
| == [[Tutorials|Tutorials]] ==
| |
| This section contains step-by-step instructional guides designed to explain PoMM tasks, concepts and processes through structured explanations and examples.
| |
| | |
| == [[Contact support|Contact support]] ==
| |
| Who to contat when.
| |
| | |
| == Case Studies and Applications ==
| |
| === Using the PoMM at the pilot sites ===
| |
| * [[PoMM for the Santander D4Runoff pilot|PoMM for the Santander D4Runoff pilot]]
| |
| * [[PoMM for the Odense D4Runoff pilot|PoMM for the Odense D4Runoff pilot]]
| |
| * [[PoMM for the Pontedera D4Runoff pilot|PoMM for the Pontedera D4Runoff pilot]]
| |
| | |
| === [[Case Studies Outside D4Runoff|Case Studies Outside D4Runoff]] ===
| |
| | |
| === [[Case Studies Used for the Templates and Library|Case Studies Used for the Templates and Library]] ===
| |
| | |
| == [[Policy Scenarios|Policy Scenarios]] ==
| |
| | |
| == [[Library of PoMM Reusable Data|Library of PoMM Reusable Data]] ==
| |
| This section includes BPMN Process Descriptions, ABM Models and Full Experiments provided by Users.
| |
|
| |
|
| == [[Technical Documentation|Technical Documentation]] ==
| | If you already know what to do, you can access the [https://d4rpomm.ufuture.eu/ Policy Making Module PoMM]. |
| 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
| |
|
| |
|
| == [[Theory of Operations|Theory of Operations]] == | | Otherwise, please keep on reading! |
| 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.
| | ===PoMM User's Manual=== |
| | If you are planning to get the most out of this application, the '''[[PoMM User Manual|PoMM User's Manual]]''' contains detailed information on the approach, its application, and best practice. Following this guidance you will understand and successfully utilise the system. |
|
| |
|
| == [[Bibliography|Bibliography]] ==
| | For qualified users short of time, the [[ Five Minutes Guide to the PoMM|<u>''Five Minutes Guide to the PoMM''</u>]] offers a quick-start tutorial and essential instructions to help users navigate and utilize the PoMM. |
| References, Data Sources and Other Web Resources
| |
|
| |
|
| == [[PoMM Privacy and Legal stuff|PoMM Privacy and Legal stuff]] == | | === Video about the PoMM === |
|
| |
|
| | * '''[https://d4rpomm.ufuture.eu/video_pomm/video.html Video of thePoMM operations]''' is a guided tour through the PoMM and its functions. |
|
| |
|
| == Site development notes (temporary) == | | === Comprehensive Knowledge Base and Full Documentation (Registered Users Only) === |
| [[D4RDocPack ToDo, tickets and hints]] | | Registered Users have access to the [[Comprehensive Knowledge Base and Full Documentation]] |
|
| |
|
| * [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
| | Dissemination Level: PU |
| * [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
| |
| * [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
| |
| * [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
| |
| * [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]
| |
|
| |
|
| Consult the [[mediawikiwiki:Special:MyLanguage/Help:Contents|User's Guide]] for information on using the wiki software.
| | [[Category:PU]] |
This is the documentation hub of the PoMM Module of the AI-Assisted urban runoff management platform of the D4Runoff project.
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 PoMM.
To access all the features of these MediaWiki pages of the D4Runoff Project, please request authorisation.
Simply send an e-mail to the following address: d4runoff-mediawiki@klink.it. Your credentials will be sent within 48 hours.
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
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.
PoMM Documentation
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.
If you already know what to do, you can access the Policy Making Module PoMM.
Otherwise, please keep on reading!
PoMM User's Manual
If you are planning to get the most out of this application, the PoMM User's Manual contains detailed information on the approach, its application, and best practice. Following this guidance you will understand and successfully utilise the system.
For qualified users 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 PoMM.
Video about the PoMM
Comprehensive Knowledge Base and Full Documentation (Registered Users Only)
Registered Users have access to the Comprehensive Knowledge Base and Full Documentation
Dissemination Level: PU