FAQ (Frequently Asked Questions): Difference between revisions
| (One intermediate revision by the same user not shown) | |||
| Line 44: | Line 44: | ||
# '''Thesaurus & Vocabulary''': browse definitions | # '''Thesaurus & Vocabulary''': browse definitions | ||
# '''Help & User’s Guide''': access documentation | # '''Help & User’s Guide''': access documentation | ||
''(Strike the right button)'' | ''([[PoMM User Manual#Strike the right button|Strike the right button]])'' | ||
=== '''What is the brief flow of operations?''' === | === '''What is the brief flow of operations?''' === | ||
| Line 51: | Line 51: | ||
# Analyze experiment outcomes | # Analyze experiment outcomes | ||
# Document & share results | # Document & share results | ||
# Overcome doubts via terminology aids ''(Brief flow of operations)'' | # Overcome doubts via terminology aids | ||
''([[PoMM User Manual#Brief flow of operations|Brief flow of operations]])'' | |||
=== '''Which modelling approaches does PoMM support?''' === | === '''Which modelling approaches does PoMM support?''' === | ||
* '''Network modelling''': maps variable relationships in procedural decision processes | |||
* '''Agent-based modelling (ABM)''': simulates interactions of actors (agents) to explore emergent behaviour | |||
''([[PoMM User Manual#Difference between network modelling and agent-based modelling|Module Overview → Difference between network modelling and agent-based modelling]])'' | |||
Start a new session, then follow the guided steps: define geography, select NBS & CECs, map the process in BPMN, annotate entities, and checkpoint. ''(Policy / decision case definition)'' | === '''How do I outline my case under study (network modelling)?''' === | ||
Start a new session, then follow the guided steps: define geography, select NBS & CECs, map the process in BPMN, annotate entities, and checkpoint. | |||
''([[PoMM User Manual#Policy / decision case definition|Policy / decision case definition]])'' | |||
=== '''How do I define geographic boundaries?''' === | === '''How do I define geographic boundaries?''' === | ||
Select NUTS 1/2/3 or LAU levels on the map interface, zoom and click to choose your area, then confirm. ''(Outline the case under study → Defining the geographic boundaries)'' | Select NUTS 1/2/3 or LAU levels on the map interface, zoom and click to choose your area, then confirm. | ||
''([[PoMM User Manual#Outline the case under study|Outline the case under study]] → Defining the geographic boundaries)'' | |||
=== '''How do I select a Natural-Based Solution (NBS)?''' === | === '''How do I select a Natural-Based Solution (NBS)?''' === | ||
From a drop-down of NBS options (populated from the AI platform’s solution library), choose and confirm, then review its description. ''(Outline the case under study → Select the targeted Natural based solution)'' | From a drop-down of NBS options (populated from the AI platform’s solution library), choose and confirm, then review its description. | ||
''([[PoMM User Manual#Outline the case under study|Outline the case under study]] → Select the targeted Natural based solution)'' | |||
=== '''How do I select Contaminants of Emerging Concern (CECs)?''' === | === '''How do I select Contaminants of Emerging Concern (CECs)?''' === | ||
Pick a CEC family (or refine by compound/CAS) from the drop-down, confirm, then optionally add notes in the unity-of-analysis dialogue. ''(Outline the case under study → Choose the targeted Contaminants of emerging concern)'' | Pick a CEC family (or refine by compound/CAS) from the drop-down, confirm, then optionally add notes in the unity-of-analysis dialogue. | ||
''([[PoMM User Manual#Outline the case under study|Outline the case under study]] → Choose the targeted Contaminants of emerging concern)'' | |||
=== '''Can I add notes to my unit of analysis?''' === | === '''Can I add notes to my unit of analysis?''' === | ||
Yes—after selecting NUTS, NBS, CECs you can leave or edit the proposed text to record comments that feed into your reports. ''(Outline the case under study → Write notes)'' | Yes—after selecting NUTS, NBS, CECs you can leave or edit the proposed text to record comments that feed into your reports. | ||
''([[PoMM User Manual#Outline the case under study|Outline the case under study]] → Write notes)'' | |||
=== '''How do I document the current decision workflow?''' === | === '''How do I document the current decision workflow?''' === | ||
Use the built-in BPMN interface to draw or upload a <code>.bpmn</code> file depicting your process flow with tasks, events, and message flows. ''(Outline the case under study → Define the actual decision workflow diagram)'' | Use the built-in BPMN interface to draw or upload a <code>.bpmn</code> file depicting your process flow with tasks, events, and message flows. | ||
''([[PoMM User Manual#Outline the case under study|Outline the case under study]] → Define the actual decision workflow diagram)'' | |||
=== '''What if I already have a BPMN diagram?''' === | === '''What if I already have a BPMN diagram?''' === | ||
Drag-and-drop your <code>.bpmn</code> file into the interface (if compatible) to load and then modify it within PoMM. ''(Outline the case under study → Upload existing BPMN)'' | Drag-and-drop your <code>.bpmn</code> file into the interface (if compatible) to load and then modify it within PoMM. | ||
''([[PoMM User Manual#Outline the case under study|Outline the case under study]] → Upload existing BPMN)'' | |||
=== '''What are process templates and how do I use them?''' === | === '''What are process templates and how do I use them?''' === | ||
Choose “Process Templates” at session start, answer a short survey (policy issue, action type, decision framework), and PoMM preloads a tailored BPMN. ''( | Choose “Process Templates” at session start, answer a short survey (policy issue, action type, decision framework), and PoMM preloads a tailored BPMN. | ||
''([[PoMM User Manual#Outline the case under study|Outline the case under study]] →Process template selection)'' | |||
=== '''How do I annotate BPMN entities with variables?''' === | === '''How do I annotate BPMN entities with variables?''' === | ||
Hover over a task/entity, click the annotation tool, and enter a variable name in square | Hover over a task/entity, click the annotation tool, and enter a variable name in square brackets these annotations drive later simulation. | ||
''([[PoMM User Manual#Outline the case under study|Outline the case under study]] →Annotate an entity of your process)'' | |||
=== '''How do I select which entities are analyzed?''' === | === '''How do I select which entities are analyzed?''' === | ||
After annotation, click “Next” to view clickable nodes on a map or drop-down; select (turns red) the variables you want in your simulation. ''( | After annotation, click “Next” to view clickable nodes on a map or drop-down; select (turns red) the variables you want in your simulation. | ||
''([[PoMM User Manual#Outline the case under study|Outline the case under study]] →Identify the most important entities for the decision workflow)'' | |||
=== '''What are Fuzzy Cognitive Maps (FCMs) in PoMM?''' === | === '''What are Fuzzy Cognitive Maps (FCMs) in PoMM?''' === | ||
FCMs represent your annotated BPMN variables as nodes with weighted causal links (–1 to +1), allowing “what-if” scenario simulations. ''( | FCMs represent your annotated BPMN variables as nodes with weighted causal links (–1 to +1), allowing “what-if” scenario simulations. | ||
''([[PoMM User Manual#Design the experiment(s)|Design the Experiments]] → FCM introduction)'' | |||
=== '''How do I build and run an FCM experiment?''' === | === '''How do I build and run an FCM experiment?''' === | ||
| Line 95: | Line 119: | ||
# Draw arrows to link concepts, set weights via the “?” icon | # Draw arrows to link concepts, set weights via the “?” icon | ||
# Save the FCM map | # Save the FCM map | ||
# Initialize starting activations and submit for simulation ''(Design & Run the experiment(s) Procedural view)'' | # Initialize starting activations and submit for simulation | ||
''([[PoMM User Manual#Implementation of policy and decision-making experiments (procedural view)|Implementation of policy and decision-making experiments (procedural view)]] → Design & Run the experiment(s) Procedural view)'' | |||
=== '''How do I interpret FCM results?''' === | === '''How do I interpret FCM results?''' === | ||
Results show equilibrium values per concept in a table and graph; focus on your target node’s change from baseline to assess intervention impact. ''(Result of intervention comparison)'' | Results show equilibrium values per concept in a table and graph; focus on your target node’s change from baseline to assess intervention impact. | ||
''([[PoMM User Manual#Implementation of policy and decision-making experiments (procedural view)|Implementation of policy and decision-making experiments (procedural view)]] → Result of intervention comparison)'' | |||
=== '''How do I launch the agent-based model (ABM)?''' === | === '''How do I launch the agent-based model (ABM)?''' === | ||
From the main menu select “Agents simulation,” which opens the NetLogo Web interface with the default urban NBS adoption model. ''(Bottom-up modelling (agent based) of the case → Agent Simulation feature)'' | From the main menu select “Agents simulation,” which opens the NetLogo Web interface with the default urban NBS adoption model. | ||
''([[PoMM User Manual#Bottom-up modelling (agent based) of the case|Bottom-up modelling (agent based) of the case]] → Agent Simulation feature)'' | |||
=== '''How do I set up and run the ABM baseline?''' === | === '''How do I set up and run the ABM baseline?''' === | ||
Click '''setup''' to initialize agents/environment, then '''go''' (stepwise) or '''go-forever''' to run the model, observing monitors and plots. ''(How to use it → ABM setup & run)'' | Click '''setup''' to initialize agents/environment, then '''go''' (stepwise) or '''go-forever''' to run the model, observing monitors and plots. | ||
''([[PoMM User Manual#Outline the case for ABM exploration|Outline the case for ABM exploration]] '''→''' How to use it → ABM setup & run)'' | |||
=== '''Which interface controls adjust ABM parameters?''' === | === '''Which interface controls adjust ABM parameters?''' === | ||
# '''Sliders''': flood/pollution frequency & intensity, numbers of agents, sensitivities | # '''Sliders''': flood/pollution frequency & intensity, numbers of agents, sensitivities | ||
# '''Switches''': inequality distribution | # '''Switches''': inequality distribution | ||
# '''Buttons''': setup, go, go-forever ''(ABM Interface: sliders, switches, buttons)'' | # '''Buttons''': setup, go, go-forever | ||
''([[PoMM User Manual#Outline the case for ABM exploration|Outline the case for ABM exploration]] →ABM Interface: sliders, switches, buttons)'' | |||
=== '''What outputs does the ABM provide?''' === | === '''What outputs does the ABM provide?''' === | ||
Monitors (NBS count, avg risk, sentiment, contamination) and plots (risk exposure, sentiment, contamination, PA attributes), plus spatial grid view. ''(ABM Interface: Monitors & Plots)'' | Monitors (NBS count, avg risk, sentiment, contamination) and plots (risk exposure, sentiment, contamination, PA attributes), plus spatial grid view. | ||
''([[PoMM User Manual#Outline the case for ABM exploration|Outline the case for ABM exploration]]→ABM Interface: Monitors & Plots)'' | |||
=== '''What are good practices for ABM experiments?''' === | === '''What are good practices for ABM experiments?''' === | ||
| Line 119: | Line 153: | ||
# Run multiple baseline & intervention runs | # Run multiple baseline & intervention runs | ||
# Use statistical tests for significance | # Use statistical tests for significance | ||
# Compare distributions and trends ''(Running ABM experiments: good practices)'' | # Compare distributions and trends | ||
''([[PoMM User Manual#Running ABM experiments: good practices|Running ABM experiments: good practices]])'' | |||
=== '''How do I document and report procedural (FCM) experiments?''' === | === '''How do I document and report procedural (FCM) experiments?''' === | ||
Use the provided '''Final Report Index''' template, detailing experiment ID, questions, BPMN/FCM setup, parameters, results, interpretation, and next steps. | Use the provided '''Final Report Index''' template, detailing experiment ID, questions, BPMN/FCM setup, parameters, results, interpretation, and next steps. | ||
''([[PoMM User Manual#An index to document and report decision-making experiments (procedural view)|Documenting & reporting]] → An index to document decision-making experiments)'' | |||
=== '''How do I document and report ABM experiments?''' === | === '''How do I document and report ABM experiments?''' === | ||
Follow the '''ABM report index''', listing experiment context, model version, parameter settings (sliders/switches), seeds, runs, outputs, analysis, and limitations. | Follow the '''ABM report index''', listing experiment context, model version, parameter settings (sliders/switches), seeds, runs, outputs, analysis, and limitations. | ||
Back to >> [[Comprehensive Knowledge Base and Full Documentation]] | ''([[PoMM User Manual#An index to document and report decision-making experiments (procedural view)|Documenting & reporting]] → An index to document and report PoMM ABM experiments)'' | ||
Back to >> [[Comprehensive Knowledge Base and Full Documentation]] | |||
Latest revision as of 16:07, 16 June 2025
Here PoMM Users find a collection of common questions and answers about a specific topics, designed to provide quick and helpful information.
What is the objective of the Policy-Making Module (PoMM)?
The PoMM enables users to analyze the impact of policy changes related to Nature-Based Solutions (NBS) for mitigating Contaminants of Emerging Concern (CECs) in urban runoff, supporting decision-makers in devising the most effective interventions.
(Module Overview → Purpose of the Policy Making Module)
Who is PoMM intended for?
It’s designed for policymakers and rule-makers (at town, province, regional levels), administrative agents, politicians, planners, and scientists involved in NBS policy formation.
(Module Overview → Who is the PoMM intended for)
What are PoMM’s key functionalities?
- Knowledge representation (terminology service, case information, experiment guidelines)
- Policy/decision case definition (BPMN-based mapping of procedures, NUTS/NBS/CEC assignment)
- Questioning, analysis & reporting (experiment design, output analysis, reporting tools)
(Module Overview → Key functionalities)
How do I access PoMM?
Log in to the AI-DSS Platform, click the PoMM link in the side menu, then accept the module-specific privacy policy.
(Module Overview → How to access the PoMM)
What are the recommended system requirements?
64-bit Windows 11/macOS Ventura/latest Linux, quad-core CPU, ≥8 GB RAM, 1080p+ display, Chrome/Firefox latest.
(Module Overview → User System / Device requirements)
Does PoMM store my session data?
No-nothing (uploads, configurations, models, reports) is saved beyond the active session; users must download and securely save outputs.
What should I avoid doing in my browser?
Do not use the browser’s back/forward buttons inside PoMM. Always use the interface’s navigation links to prevent session loss.
- Start New Session: begin from scratch
- Restore Session: resume a saved session
- Process Templates: start with a pre-configured survey
- Agents Simulation: launch ABM experiments
- Thesaurus & Vocabulary: browse definitions
- Help & User’s Guide: access documentation
What is the brief flow of operations?
- Describe case under study
- Define intervention
- Analyze experiment outcomes
- Document & share results
- Overcome doubts via terminology aids
Which modelling approaches does PoMM support?
- Network modelling: maps variable relationships in procedural decision processes
- Agent-based modelling (ABM): simulates interactions of actors (agents) to explore emergent behaviour
(Module Overview → Difference between network modelling and agent-based modelling)
How do I outline my case under study (network modelling)?
Start a new session, then follow the guided steps: define geography, select NBS & CECs, map the process in BPMN, annotate entities, and checkpoint.
(Policy / decision case definition)
How do I define geographic boundaries?
Select NUTS 1/2/3 or LAU levels on the map interface, zoom and click to choose your area, then confirm.
(Outline the case under study → Defining the geographic boundaries)
How do I select a Natural-Based Solution (NBS)?
From a drop-down of NBS options (populated from the AI platform’s solution library), choose and confirm, then review its description.
(Outline the case under study → Select the targeted Natural based solution)
How do I select Contaminants of Emerging Concern (CECs)?
Pick a CEC family (or refine by compound/CAS) from the drop-down, confirm, then optionally add notes in the unity-of-analysis dialogue.
(Outline the case under study → Choose the targeted Contaminants of emerging concern)
Can I add notes to my unit of analysis?
Yes—after selecting NUTS, NBS, CECs you can leave or edit the proposed text to record comments that feed into your reports.
(Outline the case under study → Write notes)
How do I document the current decision workflow?
Use the built-in BPMN interface to draw or upload a .bpmn file depicting your process flow with tasks, events, and message flows.
(Outline the case under study → Define the actual decision workflow diagram)
What if I already have a BPMN diagram?
Drag-and-drop your .bpmn file into the interface (if compatible) to load and then modify it within PoMM.
(Outline the case under study → Upload existing BPMN)
What are process templates and how do I use them?
Choose “Process Templates” at session start, answer a short survey (policy issue, action type, decision framework), and PoMM preloads a tailored BPMN.
(Outline the case under study →Process template selection)
How do I annotate BPMN entities with variables?
Hover over a task/entity, click the annotation tool, and enter a variable name in square brackets these annotations drive later simulation.
(Outline the case under study →Annotate an entity of your process)
How do I select which entities are analyzed?
After annotation, click “Next” to view clickable nodes on a map or drop-down; select (turns red) the variables you want in your simulation.
(Outline the case under study →Identify the most important entities for the decision workflow)
What are Fuzzy Cognitive Maps (FCMs) in PoMM?
FCMs represent your annotated BPMN variables as nodes with weighted causal links (–1 to +1), allowing “what-if” scenario simulations.
(Design the Experiments → FCM introduction)
How do I build and run an FCM experiment?
- Load annotated nodes (Load button)
- Drag/drop nodes onto the canvas
- Draw arrows to link concepts, set weights via the “?” icon
- Save the FCM map
- Initialize starting activations and submit for simulation
(Implementation of policy and decision-making experiments (procedural view) → Design & Run the experiment(s) Procedural view)
How do I interpret FCM results?
Results show equilibrium values per concept in a table and graph; focus on your target node’s change from baseline to assess intervention impact.
(Implementation of policy and decision-making experiments (procedural view) → Result of intervention comparison)
How do I launch the agent-based model (ABM)?
From the main menu select “Agents simulation,” which opens the NetLogo Web interface with the default urban NBS adoption model.
(Bottom-up modelling (agent based) of the case → Agent Simulation feature)
How do I set up and run the ABM baseline?
Click setup to initialize agents/environment, then go (stepwise) or go-forever to run the model, observing monitors and plots.
(Outline the case for ABM exploration → How to use it → ABM setup & run)
Which interface controls adjust ABM parameters?
- Sliders: flood/pollution frequency & intensity, numbers of agents, sensitivities
- Switches: inequality distribution
- Buttons: setup, go, go-forever
(Outline the case for ABM exploration →ABM Interface: sliders, switches, buttons)
What outputs does the ABM provide?
Monitors (NBS count, avg risk, sentiment, contamination) and plots (risk exposure, sentiment, contamination, PA attributes), plus spatial grid view.
(Outline the case for ABM exploration→ABM Interface: Monitors & Plots)
What are good practices for ABM experiments?
- Define your objective & hypothesis
- Choose observables
- Run multiple baseline & intervention runs
- Use statistical tests for significance
- Compare distributions and trends
(Running ABM experiments: good practices)
How do I document and report procedural (FCM) experiments?
Use the provided Final Report Index template, detailing experiment ID, questions, BPMN/FCM setup, parameters, results, interpretation, and next steps.
(Documenting & reporting → An index to document decision-making experiments)
How do I document and report ABM experiments?
Follow the ABM report index, listing experiment context, model version, parameter settings (sliders/switches), seeds, runs, outputs, analysis, and limitations.
(Documenting & reporting → An index to document and report PoMM ABM experiments)
Back to >> Comprehensive Knowledge Base and Full Documentation