Tutorial: Editing a model

This tutorial show  the edition of a simple case, the travel tours agency.

Description of the case

see the description of the travel-tour agency case

Editing the model of the organization

Once Soclab is properly installed and running (see the Getting started section),  create a new model, using New Model in File menu.

→ Select the directory of the model where all the files will be stored

→ Enter the name of the file

1) Organization Model / Model Editor

Add the actors in the left side list. There are two:  Director and Secretary.

You can Edit a description for a selected actor, and then Save your description.

Add the relations in the right side list. There are three:  give information, control the work, renew the contract.

The Edition of a relation includes 2 parts:

  • DESCRIPTION: enter the text of the relation description.
  • QUALITATIVE SCALE OF SCALES: you will be able to define intervals within the [-10, +10] range of value of the relation state, and to qualify the controller actor’s behavior corresponding to each interval. This qualification will be used in the analysis of the model, to provide concrete interpretations of numerical values of the relation state.

Apply: don’t forget to save the changes in the model!

→ Select the ‘File / Save Model’ menu item to store your work on the hard-disk of your computer.

You will have later the possibility to add new, delete or rename actors and relations.

→ Once the actors and relations of the model are defined and saved, use the Parameters button or select the ‘Organization Model/Parameter Editor’ menu item to continue.

Organization Model / Parameter Editor

2) controls panel

→ Click the Edit button.

→ For each relation, check the box in the column of the controller actor.

→ Click the Save button.

3) stakes panel

→ Click the Edit button.

→ For each actor and relation, select the value of the actor’s stake on the relation.

The sum of the stakes of each actor is expected to equal 10, but it can be different.

→ Click the Save button.

Selecting one of the stake boxes, the Edit Description button allows you to justify the chosen value.

4) Effects panel

→ Select the function box at the  ‘give information’ row ant ‘Secretary’ column.

→ Click the Edit Effect button.

→ function list: choose item Quadratic.

→ a, b, c boxes: select the values -1.0, 4.0, 1.0 respectively.

→ Click the accept button.

The Edit Description button allows you to justify the shape of the function.

Repeat this operation for each of the effect functions.

Apply: don’t forget to save the changes in the model.

→ Select the ‘File/save model’ menu item to store the file of the model.

5) Solidarity  panel

Keep the default values: the Director is solidary only with himself (his satisfaction doesn’t account the secretary’s capability of action) and the Secretary does the same.

5) Constraints panel

For the sake of illustration, we will assume that:
the more the secretary gives information, the more the director is obliged to kindly renew the contract
or, equivalently:
the higher the state of the ‘give information’ relation, the higher the state of the ‘control the work’ relation.

So we will define a constraint function so that an increase in the value of the state of relation ‘give information’ provokes an increase in the lower bound of the state of relation ‘renew the contract’.

→ Select the function box at the line ‘give information’ and column ‘renew the contract’.

→ Click the ‘Edit Constraint’ button

→ Select the lower control panel.

→ function list: select the linear item.

→ a (slope): select 5

→ b (y-intercept): select -5

→ Click the accept button.

Now your are ready to:

  • launch simulations in order to compute how each actor could presumably behave in the management of the relations he control,
  • or analyze the states and the structural properties of this model.