# State Analysis

State Analysis module describes some particular states of the organization by computing the corresponding  Satisfaction/Action Capacity and Power/Influence values for the Actors. See the [TODO LINK] page for a description of these measures.

Contents:

State Analysis module is launched by selecting the Organization ModelState Analysis menu. This is what it looks like when it pops up :

State Analysis module (click to enlarge)

The module interface frame is divided in two zones. Left zone deals with selecting and manipulating states, right zone shows the measures corresponding to the selected state, as tables or histograms.

### Selecting and Manipulating States

User states cell

The upper cell allows to define manually some organization states, by entering state values in the State/Interpretation tab of the right zone of the frame.
New : creates a new user state, whose name is entered in the lower text field.
Edit : allows to edit the selected user state. In Table Mode, Relations states values are entered in the table of the State/Interpretation tab (hit the [Enter] key to validate a value). In Graphical Mode, Relations states are defined by moving sliders.
Save : save state values and exits the state edition mode.
Save all : save all the user states. Every user state will be lost if the State Analysis module is closed without saving.

#### Significant States cell and Actors States cell

These cells allow to select some pre-computed significant states of an organization. Significant states cell show two Nash equilibrium states, and possibly the mean convergence state, if State analysis module is triggered from the Simulation module.
Actors States allows to select with radio buttons the state(s) that maximizes or minimizes some measures, for an Actor or the whole organization (Global).

Show : displays the selected state and associated measures in the right zone tabs.
Export : send a copy of the selected significant state to the user states lists.
Next (1/n) : If several states match the criteria of “significance”, this button display the next matching state.

For any state, details can be viewed in two modes: Table Mode (default) and Graphical Mode.

### Table Mode Display

By default, State Analysis displays the details of a particular state as five tables, each one being framed in a tab of the right zone. These tabs are:

• State/Interpretation tab : displays each Relation state value, and the associated interpretation (defined in Model Editor module).
• Influence/Satisfaction tab : displays a table showing the contributions the Actors, one to another.  A row of this table shows the satisfaction of an actor with the detail, by column, of each actor’s contribution ; the last cell of a row being the satisfaction itself.
INFLUENCE row : the sum of an Actor’s contributions to the others.
ABSOLUTE INFLUENCE row : the sum of an Actor contributions’ absolute values.
COOPERATIVE INFLUENCE : the sum of positives contributions only.
At the intersection of satisfaction column and influence row is the average of Actors’ satisfactions (which is also the average of Actors’ influences).
• Power/ActionCapacity  tab  is the the same as the Influence/Satisfaction tab, but without taking solidarities into account, i.e.  Action Capacity instead of Satisfaction, and Power instead of Influence.
• Influence/Satisfaction% and Power/ActionCapacity% are similar to the two previous tabs, but each value is expressed as a percentage of its interval: 100% is the maximum value, 0% the minimum value and 50% is $\frac{max-min}{2}$ .

Any table can be added to a report, using the Add panel to Report button. Constraints are taken into account by clicking the With Constraints tick-box in the lower right corner.

### Graphical Mode Display

State analysis module also comes with a graphical visualization of the values displayed in the Table mode. This visualization is triggered by the Graphical Mode button

Graphical mode of State Analysis module (click to enlarge)

Satisfaction, Action Capacity, Power and Influence appear as colored histograms, each Actor’s contribution being drawn with its own color. Relations state values appear as sliders, on the top of histograms. Visualization or Sliders values  can be added to a report using the appropriate  Add [...] to Report button. Notice that when editing one of the users states, you can modify Relations states values using the sliders. The Display tick-box triggers the update of the histograms when the sliders are moved.