Running

1. Java Runtime Environment (JRE) 1.6 or above

Development

1. Java Runtime Environment (JRE) 1.6 or above
2. Ecplise environment
3. Eclipse plugin Repast Simphony 2.0.0 beta

Basic Instructions

After downloading the zip-package SoNOMoDe-CMOT2012_run.zip extract its content to a location of your choice.

Setting up Database

Although parameters can be set through XML files (see Parameter Definition) the database is useful in order to apply shipped parameter sets and in order to analyse simulation results (e.g. by application of shipped R-scripts).

In case you cannot set up the database you need to by-pass parameter reading from the database. By-passing is enabled by setting SQL_TBLNAME_PARAMS in the DB Settings XML file to "NOT DEFINED" (which is already set):

<SQL_TBLNAME_PARAMS>NOT DEFINED</SQL_TBLNAME_PARAMS>

Furthermore, these parameter settings are required in the ./config/param/Parameters.xml file (they are contained but need to be uncommented):

<de.cesr.sesamgim.param.GInitialisersPa:INITIALISER_AGENTS>de.cesr.sesamgim.init.agent.GFileAgentInitialiser</de.cesr.sesamgim.param.GInitialisersPa:INITIALISER_AGENTS>
<de.cesr.sesamgim.param.GBasicPa:INIT_PARAM_ID>0</de.cesr.sesamgim.param.GBasicPa:INIT_PARAM_ID>

Note: This way it is not possible to set milieu-specific parameters like preference or network properties since these require complex data types that are not easily to define in XML structures.

The SQL file ./config/sql/InitDatabase.sql should be executed in order to add required tables to your preferred MySQL database. It contains both:

1. Empty tables for results.
2. Parameter tables with predefined parameter settings.
3. A run table that associates result data with applied parameter sets (see ParMa for details).

   Make sure adapting the table name parameters in SqlPa, for instance using an XML parameter definition in PreParameters.xml (again, see ParMa for instructions).

   Adapt the database configuration files ./config/DBSettings.xml and ./config/DBSettingsSocNet.xml.

Adapting Configurations

See section Usage for instructions on parameter setting. There is also information about batch runs, logging etc.

Executing Run Scripts

This packages comes with execution scripts in order to run the model.

Besides custom parameter settings via XML files you need to define the parameter set ID to run in ./config/batch/batch_params.xml. Furthermore, you might need to adapt java memory settings to your specific hardware.

Configuring Eclipse

1. Download eclipse according to your OS
2. Install Plugins
   1. Repast Simphony
   2. Subclipse (optional if you like version control)