Copyright (c) 2016 Alessandro Caiani and Antoine Godin

##Overview

The folder contains the model-specific code empolyed for the model presented in the working paper available here , the summary tables of the experiments discussed in the paper, and additional materials to run simulations by your own and analyze results.

The code requires and builds upon the JMAB platform (JMAB project): a Java framework for building macro stock-flow consistent agent-based simulation models. A simulation model is constructed using dependency injection by creating a Spring beans configuration file which specifies which classes to use in the simulation and the values of any attributes (parameters). The Spring configuration file is specified using the system property jabm.config.

The main application class is DesktopSimulationManager

##Additional Contents

The folder "paper" contains:

• The pdf document of the working paper presenting the model ( here)

• The Summary Tables with the quasi-SS characterization in the Baseline Scenario and the Sensitivity Experiments ( here) discussed in the working paper available here

• The Summary Tables of the Cross Correlation Analysis in the Baseline and in each Sensitivity experiment. See the "Correlations" folders within the "Baseline" and "Sensitivity" folders here

• All the Plots Produced in the Experiments. In the case of the sensitivity experiments lighter grey lines correspond to higher values of the parameter. Baseline: here. Sensitivity: here

• The Executable Files to run simulations of the benchmark model by your own (in both the Baseline and Sensitivity Scenarios) and the R Scripts required to transform and analyze the results, and plot the figures. (See Read Me doc. in the “Launch Simulations” Folder). Available here.

##Prerequisites

JMAB requires Java version 6 or later. It has been tested against version 1.6.0_35 and 1.7.0_75.

Note that on Mac OS, you will need to use the Oracle version of Java instead of the default one shipped with the OS.

##Installation

The project archive can be imported directly into the Eclipse IDE as an existing project.

##Running the examples from the Eclipse IDE

The distribution archive can be imported directly into the Eclipse IDE by using the File/Import menu item. Create a launch configuration in the benchmark project with the main class benchmark.Main and specify which configuration file you want to use by setting the system property jabm.config using the JVM argument -D , for example

-Djabm.config=model/mainBaseline.xml

##Documentation

The folder documentation in the JMAB project contains a user guide.

The folder paper contains the last working paper version of the model description, plus the data generated by the simulation used for the paper, and the corresponding graphs. It also contains a jar that can be used to run the simulation directly from the console

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.