New Session Help Page: Difference between revisions

From D4RPoMM
Jump to navigation Jump to search
No edit summary
Line 138: Line 138:


=== 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:RicToDo]]

Revision as of 10:36, 14 February 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


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

(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)".
(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

Cambierei il messaggio al centro della pagina e lo farei con un titolo un po' più grande e una seconda linea di spiegazione:
"Describe the decision-making process you want to analyse."
"Depict the decision-making process by creating a new BPMN diagram. 
While drawing the process keep in mind the central policy issue you are dealing with. 
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.
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. 
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. 
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. 
When in doubt, always consult the Help"

Identification of the most important entities

Titolo "Identification of the most important entities for the decision workflow"
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 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. 
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

Ripeterei due volte il titolo, uno per ciascun box, quindi il primo con la sua descrizione sarebbe:
"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."
Nel box, come testo di default, scriverei : 
"The diagram describes the process examined according to the BPMN standard."

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"
"The annotations refer to the variables considered important or critical for the issue of policy making / decision making under consideration."

Download the Intermediate Report

Titolo "Download the Intermediate Report 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."
"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"

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.

Qui cambierei solo il bottone così "Go to Building the Cognitive Map"

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

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

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)

 before setting the initial value of the entities. 

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.

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

IL TITOLO QUI NON VA BENE
Notes about the cognitive map of relations among entities
Cognitive map

Report of the work session

Reading the report of the experiment

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?