FAQ (Frequently Asked Questions) - Revision history

AnnaRodeghiero: /* How do I document and report ABM experiments? */

2025-06-16T14:07:30Z

How do I document and report ABM experiments?

← Older revision		Revision as of 16:07, 16 June 2025
Line 165:		Line 165:

	''([[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)''		''([[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]]
	Back to >> [[Comprehensive Knowledge Base and Full Documentation]]

AnnaRodeghiero: /* What are the main navigation buttons? */

2025-04-27T14:11:06Z

What are the main navigation buttons?

Show changes

AnnaRodeghiero: /* What is the objective of the Policy-Making Module (PoMM)? */

2025-04-27T13:41:33Z

What is the objective of the Policy-Making Module (PoMM)?

AnnaRodeghiero at 13:38, 27 April 2025

2025-04-27T13:38:20Z

Show changes

AnnaRodeghiero at 13:34, 27 April 2025

2025-04-27T13:34:05Z

← Older revision		Revision as of 15:34, 27 April 2025
Line 2:		Line 2:

	# '''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. ''([[PoMM User Manual#Purpose of the Policy Making Module\|Module Overview → Purpose of the Policy Making Module]])''		# '''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. ''([[PoMM User Manual#Purpose of the Policy Making Module\|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. ''(M[[PoMM User Manual#Who is the PoMM intended for\|~~odule~~ Overview → Who is the PoMM intended for]])''		# '''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. ''([[PoMM User Manual#Who is the PoMM intended for\|Module Overview → Who is the PoMM intended for]])''
	# '''What are PoMM’s key functionalities?'''		# '''What are PoMM’s key functionalities?'''
	## '''Knowledge representation''' (terminology service, case information, experiment guidelines)		## '''Knowledge representation''' (terminology service, case information, experiment guidelines)

AnnaRodeghiero at 13:33, 27 April 2025

2025-04-27T13:33:24Z

← Older revision		Revision as of 15:33, 27 April 2025
Line 2:		Line 2:

	# '''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. ''([[PoMM User Manual#Purpose of the Policy Making Module\|Module Overview → Purpose of the Policy Making Module]])''		# '''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. ''([[PoMM User Manual#Purpose of the Policy Making Module\|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)''		# '''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. ''(M[[PoMM User Manual#Who is the PoMM intended for\|odule Overview → Who is the PoMM intended for]])''
	# '''What are PoMM’s key functionalities?'''		# '''What are PoMM’s key functionalities?'''
	## '''Knowledge representation''' (terminology service, case information, experiment guidelines)		## '''Knowledge representation''' (terminology service, case information, experiment guidelines)

AnnaRodeghiero at 13:32, 27 April 2025

2025-04-27T13:32:31Z

← Older revision		Revision as of 15:32, 27 April 2025
Line 1:		Line 1:
	Here PoMM Users find a collection of common questions and answers about a specific topics, designed to provide quick and helpful information.		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. ''([[PoMM User's Manual\|Module Overview → Purpose of the Policy Making Module]])''		# '''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. ''([[PoMM User Manual#Purpose of the Policy Making Module\|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)''		# '''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?'''		# '''What are PoMM’s key functionalities?'''

AnnaRodeghiero at 13:30, 27 April 2025

2025-04-27T13:30:55Z

← Older revision		Revision as of 15:30, 27 April 2025
Line 1:		Line 1:
	Here PoMM Users find a collection of common questions and answers about a specific topics, designed to provide quick and helpful information.		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)''		# '''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. ''([[PoMM User's Manual\|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)''		# '''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?'''		# '''What are PoMM’s key functionalities?'''

AnnaRodeghiero at 13:29, 27 April 2025

2025-04-27T13:29:06Z

← Older revision		Revision as of 15:29, 27 April 2025
Line 1:		Line 1:
	Here PoMM Users find a collection of common questions and answers about a specific topics, designed to provide quick and helpful information.		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. ''(A matter of privacy)''
			# '''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. ''(A matter of privacy)''
			# '''What are the main navigation buttons?'''
			## '''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 ''(Strike the right button)''
			# '''What is the brief flow of operations?'''
			## Describe case under study
			## Define intervention
			## Analyze experiment outcomes
			## Document & share results
			## Overcome doubts via terminology aids ''(Brief flow of operations)''
			# '''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 <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)''
			# '''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)''
			# '''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. ''(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. ''(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. ''(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. ''(Questioning, analysis & reporting → 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 ''(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. ''(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. ''(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 ''(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. ''(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]]		Back to >> [[Comprehensive Knowledge Base and Full Documentation]]

AnnaRodeghiero at 15:16, 1 April 2025

2025-04-01T15:16:39Z

← Older revision		Revision as of 17:16, 1 April 2025
Line 1:		Line 1:
	Here PoMM Users find a collection of common questions and answers about a specific topics, designed to provide quick and helpful information.		Here PoMM Users find a collection of common questions and answers about a specific topics, designed to provide quick and helpful information.

			Back to >> [[Comprehensive Knowledge Base and Full Documentation]]

← Older revision		Revision as of 15:41, 27 April 2025
Line 2:		Line 2:

	=== '''What is the objective of the Policy-Making Module (PoMM)?''' ===		=== '''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. ''([[PoMM User Manual#Purpose of the Policy Making Module\|Module Overview → Purpose of the Policy Making Module]])''		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.

			''([[PoMM User Manual#Purpose of the Policy Making Module\|Module Overview → Purpose of the Policy Making Module]])''

	=== '''Who is PoMM intended for?''' ===		=== '''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. ''([[PoMM User Manual#Who is the PoMM intended for\|Module Overview → Who is the 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.

			''([[PoMM User Manual#Who is the PoMM intended for\|Module Overview → Who is the PoMM intended for]])''

	=== '''What are PoMM’s key functionalities?''' ===		=== '''What are PoMM’s key functionalities?''' ===
	# '''Knowledge representation''' (terminology service, case information, experiment guidelines)		# '''Knowledge representation''' (terminology service, case information, experiment guidelines)
	# '''Policy/decision case definition''' (BPMN-based mapping of procedures, NUTS/NBS/CEC assignment)		# '''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)''		# '''Questioning, analysis & reporting''' (experiment design, output analysis, reporting tools)
			''([[PoMM User Manual#Key functionalities\|Module Overview → Key functionalities]])''

	=== '''How do I access PoMM?''' ===		=== '''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)''		Log in to the AI-DSS Platform, click the PoMM link in the side menu, then accept the module-specific privacy policy.

			''([[PoMM User Manual#How to access the PoMM\|Module Overview → How to access the PoMM]])''

	=== '''What are the recommended system requirements?''' ===		=== '''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)''		64-bit Windows 11/macOS Ventura/latest Linux, quad-core CPU, ≥8 GB RAM, 1080p+ display, Chrome/Firefox latest.

			''([[PoMM User Manual#User System / Device requirements\|Module Overview → User System / Device requirements]])''

	=== '''Does PoMM store my session data?''' ===		=== '''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. ''(A matter of privacy)''		No-nothing (uploads, configurations, models, reports) is saved beyond the active session; users must download and securely save outputs.

			''([[PoMM User Manual#A matter of privacy\|A matter of privacy]])''

	=== '''What should I avoid doing in my browser?''' ===		=== '''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. ''(A matter of privacy)''		Do not use the browser’s back/forward buttons inside PoMM. Always use the interface’s navigation links to prevent session loss.

			''([[PoMM User Manual#A matter of privacy\|A matter of privacy]])''

	=== '''What are the main navigation buttons?''' ===		=== '''What are the main navigation buttons?''' ===
Line 30:		Line 43:
	# '''Agents Simulation''': launch ABM experiments		# '''Agents Simulation''': launch ABM experiments
	# '''Thesaurus & Vocabulary''': browse definitions		# '''Thesaurus & Vocabulary''': browse definitions
	# '''Help & User’s Guide''': access documentation ''(Strike the right button)''		# '''Help & User’s Guide''': access documentation
			''(Strike the right button)''

	=== '''What is the brief flow of operations?''' ===		=== '''What is the brief flow of operations?''' ===