Header image CIRAD
From Conceptual Modelling to Simulation  
line decor
line decor


The MIRANA model is used to assess the impact of management transfer to local communities on sustainable development of their territories (including the ecological, social and economic aspects).

Distribution - This model distribution is made of three folders:

  • mirana: is the plugin containing all the hard-coded behaviour of the model, to be unziped and put in the folder "plugins" where the mimosa application is.
  • miranaModel: contains the model project together with the conceptual and concrete mirana models. Unzip this file in the Mimosa1.3.3.1/examples directory.
  • Sites: contains an example of the parametrization of the model using excel and shape files with the following content:
    • loaddb.sh *: is a shell script to load all the parametrization files into Postgresql or Antontona.backup is the backup of the data base as created by loaddb.sh (just in case)
    • Excel2DB: contains a java program to load individual excel sheets into Postgresql after modification (also called from loaddb.sh)
    • Antontona.backup: the data base backup to be loaded in postgresql
    • Antontona: contains the parameterization of a particular case and contains:
      • Base de donnĂ©es.xls: the system description (only the sheets without a "U" are used)
      • Moyens de gestion.xls: the regulations description (same convention!)
      • shapefiles: the folder containing all the necessary maps.

Setup - Be sure to follow the following steps:

  1. Download and install Postgresql (http://www.postgresql.org/). Version 9.0 recommended.
  2. Download and install the PostGIS 1.5 extension of PostgreSQL 9.0 (http://postgis.refractions.net/)
  3. Download and install the last version of Mimosa (currently (http://sourceforge.net/projects/mimosa) where you want (Windows: recommend C:\Mimosa1.3.3.1)
  4. Put the folder "mirana" into the plugins folder of the mimosa distribution
  5. In postgresql create the role "madagascar" with the password "mirana". Do this using the pgAdmin III interface using the following steps:
    1. Start pgAdmin III (under the Windows start menu find PostgrSQL 9.0 and select pgAdmin III)
    2. either:
      • do:
        1. Highlight postgres in the Object browser then select the Query Tool under the Tools pull-down menu
        2. In the SQL Editor type exactly: CREATE ROLE madagascar WITH LOGIN PASSWORD 'mirana'
        3. Under the Query pull-down menu choose Execute (or F5)
        4. Close the Query Tool.
      • or do:
        1. Highlight and open postgres in the Object browser
        2. Right click "Connexion roles"
        3. In the entry window, enter madagascar under the property tab
        4. Enter mirana under the definition tab
        5. Select "Superuser" and "Can create databases" under the role rights tab (otherwise loaddb.sh would not work)
        6. Click OK.
  6. Either create the "Antontona" data base (the owner must be madagascar) and restore it from "Antontona.backup", or run "./loaddb.sh Antontona" from a command line. Here is how to create and restore in pgAdmin III for PostgreSQL 9.0:
    1. Right Click "Databases" in teh Object browser and select New database
    2. In the entry window, Name = Antontona and choose the Owner = madagascar. Click OK. The new database shell will be in the Object browser.
    3. In the Object browser, right click Antontona and select Restore. You should have unzipped the Sites.zip file somewhere, then you can select that path and find the Antontona.backup file. Click OK and the restoration will begin and end with a long list of messages. Click Cancel when done. This is what Antontona should look like in the Object browser if you open up its folders:

Running Mirana - Be sure to follow the following steps:

  1. In Windows, create a shortcut to Mimosa by going into the Mimosa1.3.3.1 directory and right-clicking the file mimosa.jar and sending a shortcut to the windows desktop. Double click the icon to run Mimosa.
    • CAUTION: if an archive extractor opens, you must fully install the latest Java distribution (http://www.java.com/)
  2. Within Mimosa, open "mirana.pml" project file that you should have unzipped from MiranaModel.zip
  3. Double click on "mirana" in the project browser then double click "Simulation models" and then select "simulation(Mirana1)"
  4. Click "Reset" to generate the model interface
  5. Click "Initialize" to create the initial state of the model
  6. Click either "Step" or "Run" (with an ending date) to run the model