New Session Help Page: Difference between revisions

From D4RPoMM
Jump to navigation Jump to search
No edit summary
 
(20 intermediate revisions by the same user not shown)
Line 6: Line 6:
=== Select the geographic code (NUTS) of the Unit of Analysis ===
=== Select the geographic code (NUTS) of the Unit of Analysis ===


NUTS are statistical codes to define a geographical area  
NUTS are statistical codes to define a geographical area. To reference countries’ regions for statistical purposes, the EU has developed a classification known as NUTS (Nomenclature of territorial units for statistics). In PoMM, NUTS are used to associate geographical location with administrative location. More information on NUTS on the EU website → https://ec.europa.eu/eurostat/web/nuts/


By selecting the level (0,1,2,3) you choose to place your analysis at a national, macro-regional, regional or provincial level respectively. Only by selecting level 3 (provincial) is it then possible to also choose the further level LAU (Local Administrative Unit) which is typically that of operational interventions on NBS.


=== Choose the NBS(s) considered for the experiment ===
=== Choose the NBS(s) considered for the experiment ===
Line 18: Line 19:
It is assumed that such analysis has already been made before using the PoMM.  
It is assumed that such analysis has already been made before using the PoMM.  


=== Notes on the reasoning behind the definition of the Unit of Analysis  ===  
=== Notes on the reasoning behind the definition of the Unit of Analysis  ===
Always keep track of the reasons and justifications for your choices.


(1) il titolo al posto di "Write Notes" potrebbe essere "Write your notes on the reasoning behind the" e poi va bene la seconda riga "Unit of analysis definition (NUTS, NBS & CEC)".
This will come in handy later when you need to explain, for example, why you've chosen to look at a whole family of pollutants rather than a specific one.  
(2) Aggiungerei subito sotto questa indicazione, in caratteri più piccoli: "This text will be included in your report. If you do not need to write anything, you can keep the default text or delete it."
(3) Nel box, come testo di default, scriverei : "The selected code corresponds to the geographical area concerned by the evaluation, according to the European statistical nomenclature NUTS/LAU. The NBS and CECs chosen for the evaluation were previously selected from the libraries of the D4Runoff platform using the criteria provided."


== Describe the decision-making process you want to analyse ==
It is also useful to remember that the analytical approach changes if you place your observations at a regional or higher level, from where you may decide not to go into much detail and therefore use the Not Applicable option.


Cambierei il messaggio al centro della pagina e lo farei con un titolo un po' più grande e una seconda linea di spiegazione:
But remember that you must select at least one target CEC (or CEC family), because that's what the PoMM is all about.
"Describe the decision-making process you want to analyse."
 
"Depict the decision-making process by creating a new BPMN diagram.  
=== Describe the decision-making process you want to analyse ===
While drawing the process keep in mind the central policy issue you are dealing with.  
Draw the decision process by creating a new BPMN diagram.  
You can also use a BPMN diagram that has already been made and upload it by dragging and dropping it here.
 
If you use a diagram prepared outside of PoMM, make sure it is in a compatible format, otherwise you'll get an error message.
As you draw the process, keep in mind the central policy issue you are dealing with.
You can replace a diagram just dragging in a new one, but before you hit NEXT!
 
Remember to add an annotation (note) to the entities that you consider potentially interesting for the subsequent modelling and simulation of policy making and interventions on it.  
You can also use an existing BPMN diagram and drag and drop it here.
These annotations will be transferred to construct the map of the decision-making workflow that you want to analyse.
 
An annotation should give the name of the main variable associated with the entity.  
If you use a diagram created outside of PoMM, make sure it's in a compatible format, otherwise you'll get an error message.
The variables should be chosen or described in such a way that they can be measured in a minimum to maximum range.
 
If you annotated a diagram that you later replaced, your annotations are lost.  
You can replace a diagram by simply dragging and dropping a new one, but before you press NEXT!
When in doubt, always consult the Help"
 
Remember to add an annotation (note) to the entities you consider potentially interesting for the subsequent modelling and simulation of policy decisions and interventions on them.
 
These annotations will be used to construct the map of the decision-making workflow you want to analyse.
 
An annotation should give the name of the main variable associated with the entity that you want to investigate in your analysis. You can have more than one annotation (variable) associated with an entity.
 
The variables should be chosen or described so that they can be measured in a minimum to maximum range.
 
If you annotate a graph that you later replace, your annotations will be lost.
 
When in doubt, always consult the Help.


=== Identification of the most important entities ===
=== Identification of the most important entities ===
Titolo "Identification of the most important entities for the decision workflow"
In this step, you select the most important entities that you want to deal with in the subsequent modelling and simulation.
Sotto metterei la descrizione
 
"In this step, you select the most important entities that you want to deal with in the subsequent modelling and simulation.
The entities you see here are those you have marked as annotations in the previous process diagram (BPMN).
The entities you see here are those you have marked as notes in the previous process diagram (BPMN).
 
In order to have a sufficient overview of the model you are experimenting with, it is best to have a maximum of 12 nodes.  
You must select each entity you want to bring to the further step of analysis. The entities you select change colour to red.
If you are dealing with the problem at a high level, 7 is often enough (if they are well defined).
 
In the next phase you can still remove or add nodes. But you can't go back.  
In order to have a sufficient overview of the model you are experimenting with, it is best to have a maximum of 12 nodes.
If you want to change the BPMN diagram, you have to start from the previous phase."
 
If you are dealing with the problem at a high level, 7 is often enough (if they are well defined).
 
In the next phase you can still remove or add nodes. '''But you can't go back.'''
 
If you want to change the BPMN diagram, you have to start from the previous phase.
   
   
=== Notes on the reasoning behind the definition of the decision workflow ===
=== Notes on the reasoning behind the definition of the decision workflow ===
Ripeterei due volte il titolo, uno per ciascun box, quindi il primo con la sua descrizione sarebbe:
This text will be included in your report.
"Notes on the reasoning behind the definition of the decision workflow"
 
"This text will be included in your report. If you do not need to write anything, you can keep the default text or delete it."
Once again, always keep track of the reasons and justifications for your choices. This will come in handy later when you need to explain, for example, why you've chosen some concepts (variables) as your focus of investigation instead of others.
Nel box, come testo di default, scriverei :
 
"The diagram describes the process examined according to the BPMN standard."
It will be very helpful also to keep your journal when you go through analysing you context from different points of view (the politician, the developer, the public manager, etc.).
 
If don't keep track of why and how you contour your domain of observation it will be very hard to make comparisons later.
 
But, if you do not need or want to write anything, you can keep the default text or delete it.


=== Notes on the reasoning behind the identification of most the important entities ===
=== Notes on the reasoning behind the identification of most the important entities ===
Questo il secondo titolo con la sua descrizione:
Notes on the reasoning behind the identification of most the important entities
"Notes on the reasoning behind the identification of most the important entities"
"The annotations refer to the variables considered important or critical for the issue of policy making / decision making under consideration."


The annotations refer to the variables considered important or critical for the issue of policy making / decision making under consideration.
=== Download the Intermediate Report ===
=== Download the Intermediate Report ===
Titolo "Download the Intermediate Report of your Experiment"
The Intermediate Report describes what you've done until this step to outline the Case under Study and set the boundaries of your Experiment.
subito dopo "The Intermediate Report describes what was done to outline the Case under Study and set the boundaries of the Experiment."
 
"In addition, the work done will be saved in a .zip file so that you can restore your session from this point, if you need so."
The work done will be saved in a .zip file so that you can restore your session from this point on, if you need so, choosing the 'RESTORE SESSION' on the start menu.
"You must download the Intermediate Report and the back-up files to be allowed to the next step".
 
e poi sotto il messaggio "Click the button below to download all the files and the report"
As a precautionary measure, the PoMM requires you to download the Intermediate Report and the back-up files to grant you access to the next step.


== Mapping how much important entities influence each other ==
=== Mapping how much important entities influence each other ===
The next section concerns the creation of the cognitive map from the most important entities previously selected.
The next section concerns the creation of the cognitive map from the most important entities previously selected.
Pressing the “LOAD” button in the upper-right interface will load the entities onto the board.  
Pressing the “LOAD” button in the upper-right interface will load the entities onto the board.  
You will be able to link them together by pulling an arrow from the entity of your choice.
You will be able to link them together by pulling an arrow from the entity of your choice.
Clicking on an entity will open a sidebar on the left side of the screen, where you can enter a variety of information about it (this is not mandatory).
Clicking on an entity will open a sidebar on the left side of the screen, where you can enter a variety of information about it (this is not mandatory).
Once you have defined the influence relationships between entities by linking them together, you can continue to the weighing step by pressing the “NEXT” button in the upper right corner.
Once you have defined the influence relationships between entities by linking them together, you can continue to the weighing step by pressing the “NEXT” button in the upper right corner.
For more comprehensive explanations, consult the manual via the help button.
For more comprehensive explanations, consult the manual via the help button.
Qui cambierei solo il bottone così "Go to Building the Cognitive Map"
=== Building the Cognitive Map ===
=== Building the Cognitive Map ===


Line 91: Line 112:


==== Saving the map ====
==== Saving the map ====
Qui ci sono un po' di cose da sistemare (salva solo il .json), altrimenti è meglio togliere o disabilitare il bottone di SAVE se si può


== Running the experiment ==  
== Running the experiment ==  
Line 105: Line 125:


=== Setting the initial state of the model (the map) ===
=== Setting the initial state of the model (the map) ===
  before setting the initial value of the entities.
Here you can define the value of the initial states for the simulation of the do-nothing scenario.  
Here you can define the value of the initial states for the simulation.  


It is possible to assign a value to more than one entity.
It is possible to assign a value to more than one entity.
Line 129: Line 148:


=== Notes on the reasoning behind simulations and reflections on outputs ===
=== Notes on the reasoning behind simulations and reflections on outputs ===
IL TITOLO QUI NON VA BENE
The experiment defined the data of the initial conditions that we established as the reference situation.
Notes about the cognitive map of relations among entities
 
Cognitive map
The observable quantities were also identified.
 
A simulation was then carried out to examine the equilibrium state of the system considered in the reference situation.
 
The interventions were then applied to the critical variables.
 
The simulations allowed us to examine and compare the effects of the interventions on the behaviour of the system with respect to the reference situation.
 
The intervention configuration considered optimal was chosen.


== Report of the work session ==
== Report of the work session ==
Line 139: Line 166:
=== Structure and use of the data files ===
=== Structure and use of the data files ===


Quanto è possibile cambiare in maniera più conseguente il naming dei file, in modo che poi anche il restore sia più semplice?


[[Category:RicToDo]]
[[Category:Help PoMM]]
[[Category:Help PoMM]]
[[Category:Help PoMM:Lab PoMM]]
[[Category:Lab PoMM]]
[[Category:Help PoMM:Lab PoMM:New Lab Session]]
[[Category:New Lab Session]]

Latest revision as of 11:02, 8 April 2025

To start a new case study from scratch you choose "Start New Session" on the main menu.

PoMM Main Menu

Define a New Case

Select the geographic code (NUTS) of the Unit of Analysis

NUTS are statistical codes to define a geographical area. To reference countries’ regions for statistical purposes, the EU has developed a classification known as NUTS (Nomenclature of territorial units for statistics). In PoMM, NUTS are used to associate geographical location with administrative location. More information on NUTS on the EU website → https://ec.europa.eu/eurostat/web/nuts/

By selecting the level (0,1,2,3) you choose to place your analysis at a national, macro-regional, regional or provincial level respectively. Only by selecting level 3 (provincial) is it then possible to also choose the further level LAU (Local Administrative Unit) which is typically that of operational interventions on NBS.

Choose the NBS(s) considered for the experiment

The NBS catalogue and the tool that helps making a reasoned choice is available outside the PoMM. It is assumed that such analysis has already been made before using the PoMM.

Choose the CEC(s) considered for the experiment

It is assumed that such analysis has already been made before using the PoMM.

Notes on the reasoning behind the definition of the Unit of Analysis

Always keep track of the reasons and justifications for your choices.

This will come in handy later when you need to explain, for example, why you've chosen to look at a whole family of pollutants rather than a specific one.

It is also useful to remember that the analytical approach changes if you place your observations at a regional or higher level, from where you may decide not to go into much detail and therefore use the Not Applicable option.

But remember that you must select at least one target CEC (or CEC family), because that's what the PoMM is all about.

Describe the decision-making process you want to analyse

Draw the decision process by creating a new BPMN diagram.

As you draw the process, keep in mind the central policy issue you are dealing with.

You can also use an existing BPMN diagram and drag and drop it here.

If you use a diagram created outside of PoMM, make sure it's in a compatible format, otherwise you'll get an error message.

You can replace a diagram by simply dragging and dropping a new one, but before you press NEXT!

Remember to add an annotation (note) to the entities you consider potentially interesting for the subsequent modelling and simulation of policy decisions and interventions on them.

These annotations will be used to construct the map of the decision-making workflow you want to analyse.

An annotation should give the name of the main variable associated with the entity that you want to investigate in your analysis. You can have more than one annotation (variable) associated with an entity.

The variables should be chosen or described so that they can be measured in a minimum to maximum range.

If you annotate a graph that you later replace, your annotations will be lost.

When in doubt, always consult the Help.

Identification of the most important entities

In this step, you select the most important entities that you want to deal with in the subsequent modelling and simulation.

The entities you see here are those you have marked as annotations in the previous process diagram (BPMN).

You must select each entity you want to bring to the further step of analysis. The entities you select change colour to red.

In order to have a sufficient overview of the model you are experimenting with, it is best to have a maximum of 12 nodes.

If you are dealing with the problem at a high level, 7 is often enough (if they are well defined).

In the next phase you can still remove or add nodes. But you can't go back.

If you want to change the BPMN diagram, you have to start from the previous phase.

Notes on the reasoning behind the definition of the decision workflow

This text will be included in your report.

Once again, always keep track of the reasons and justifications for your choices. This will come in handy later when you need to explain, for example, why you've chosen some concepts (variables) as your focus of investigation instead of others.

It will be very helpful also to keep your journal when you go through analysing you context from different points of view (the politician, the developer, the public manager, etc.).

If don't keep track of why and how you contour your domain of observation it will be very hard to make comparisons later.

But, if you do not need or want to write anything, you can keep the default text or delete it.

Notes on the reasoning behind the identification of most the important entities

Notes on the reasoning behind the identification of most the important entities

The annotations refer to the variables considered important or critical for the issue of policy making / decision making under consideration.

Download the Intermediate Report

The Intermediate Report describes what you've done until this step to outline the Case under Study and set the boundaries of your Experiment.

The work done will be saved in a .zip file so that you can restore your session from this point on, if you need so, choosing the 'RESTORE SESSION' on the start menu.

As a precautionary measure, the PoMM requires you to download the Intermediate Report and the back-up files to grant you access to the next step.

Mapping how much important entities influence each other

The next section concerns the creation of the cognitive map from the most important entities previously selected. Pressing the “LOAD” button in the upper-right interface will load the entities onto the board.

You will be able to link them together by pulling an arrow from the entity of your choice.

Clicking on an entity will open a sidebar on the left side of the screen, where you can enter a variety of information about it (this is not mandatory).

Once you have defined the influence relationships between entities by linking them together, you can continue to the weighing step by pressing the “NEXT” button in the upper right corner.

For more comprehensive explanations, consult the manual via the help button.

Building the Cognitive Map

Load the most important entities previously selected

Moving, adding or removing entities

Linking entities

Weights

Documenting the content of the map

Saving the map

Running the experiment

Understanding the model: Network Analysis of the map

The first step is to examine the topology of the network just designed, before setting its initial state.

This is a static network analysis of the model, and tells, at least:

  • which entities (nodes) are influenced but do not influence any other; possibly these are either the ultimate effects to be observed, or targets to achieve;
  • which nodes on the contrary do influence other nodes but are not influenced; possibly these are drivers, root causes;
  • how much is a node connected (how many connections it has, both inbound and outbound); the centrality of a node give an idea of its visibility to other nodes, though not necessarily importance in a dynamic behavior.

Many other network analysis indicators can be computed, but network analysis observes the static layout of the map, which instead is used dynamically for simulation (actually it is a neural network).

Setting the initial state of the model (the map)

Here you can define the value of the initial states for the simulation of the do-nothing scenario.

It is possible to assign a value to more than one entity.

Remeber to leave unchanged (you must set = 0) your observables, that is the entities for which you intend to evaluate the effect of the simulation.

Simulation and analysis of behaviour without intervention (do nothing case)

Analysing the behaviour of the modeled system without intervention (do nothing case)

Simulation and analysis of behaviour under different initial conditions (What if)

Analysing the behaviour of the modeled system without intervention under different initial conditions.

To run a new simulation with a different initial state, go back and re-set the variables.

Keep in my mind that if you go to next section (intervention), the latter state is considered for intervention.

Defining interventions

Adding more interventions

Analysis of simulation outputs

Notes on the reasoning behind simulations and reflections on outputs

The experiment defined the data of the initial conditions that we established as the reference situation.

The observable quantities were also identified.

A simulation was then carried out to examine the equilibrium state of the system considered in the reference situation.

The interventions were then applied to the critical variables.

The simulations allowed us to examine and compare the effects of the interventions on the behaviour of the system with respect to the reference situation.

The intervention configuration considered optimal was chosen.

Report of the work session

Reading the report of the experiment

Structure and use of the data files