Creating and Editing an organization model

Creation & Edition
Model Panel
Parameters Panel
Parameters Sub-Panels

Creation & Edition

The File menu allows to classically create a new model, save it,  open some previous models.
Once saved, the model appears as a .org file.

The Organization Model menu gathers the Model Editor, the Structural Analysis module, and the State Analysis module.

The Model Editor is where the structure of the organization is created/modified. Notice that the edition  or modification of a model is not possible as long as any other module is opened at the same time.

A model is created following this meta-model:

For further description of this meta-model elements, see this page.

This module features three panels:

  • The Model panel, where you create, rename or delete some Actors and Relations.
  • The Parameters panel, where you define controls, stakes, effects, solidarities and constraints.
  • The Description panel, where you can write a description of the model file, stating background and hypothesis elements to clarify the model.

Model Panel

Actors and Relations are created by writing their names in the corresponding fields and by clicking the add Actor or the add Relation button, or pressing the  [Enter] key.

A description can be written for each Actor and/or Relation by clicking on the description button. During the description of a Relation (EditionQualitative scale of state), some interpretations can be associated to state values intervals, who will be used in the State Analysis module.

Parameters Panel

For each of the Parameters sub-panels the following buttons are available:

Edit : This button lock or unlock the edition of Controls, Stakes, Solidarities, Fuzzy stakes and Fuzzy Solidarities. Once unlocked, the button turns green and modification of parameters is possible.

Apply : validates the model edition and updates the current model (N.B. it does not save these modifications into the .org file ! ).

Close : (obviously) closes the Model Editor module.

Description :  allows to write a specific description for each Parameters sub-panel (controls, stakes, effects and so on…).

Save report : generates a .rtf file containing all the model’s elements and parameters with the corresponding descriptions.

Parameters sub-panels

Controls : where you define for each Relation:

  • the upper and lower bounds (b_min and b_max) of each relation state space.
  • the Actor that controls each Relation.
  • the Frequency , i.e. the probability for a relation  state to be modified during a simulation step.

Stakes : This panel allows to define the stakes of an Actor on every Relation he depends on. The stakes of an Actor should sum up to 10.

Effects : This panel allows to define the effect functions and their parameters, for every Relation an Actor depends on. Several classes of function are available e.g. Linear, Quadratic and Sigmoid. See [TODO LINK] for further details about effect functions.

Constraint : Constraints functions define how the state of a Relation R1 (the constraining relation) can restrict the state space of another Relation R2 (the constrained Relation). These functions associate  the b_min and b_max values of R2 (on y-axis) to the state of R1 (on x-axis).

Solidarities : This panel allows to define the solidarity an Actor A1 (in row) put on the others (in columns).

Fuzzy Stakes, Fuzzy Solidarities : Instead of constant values, stakes and solidarities can be defined as fuzzy variables, whose values will randomly vary within an interval during a simulation. These intervals are defined in theses panels.