EES-Jadex Layer Installation

In the following, the Installation for EES-Jadex is described, the Jadex integration layer that connects Jadex Agents with MATSim.

1. Download/Clone this repository and process the Setup and Build package as described below. Also, note that one of the submodules is pointed to another forked repository BDI-ABM Integration.

2. The AMOD University Campus Scenario is in the following path: ees/scenarios/matsim-drt-frankfurt-campus-westend-example

3. Update the path(s) in the following class(es):

   • XmlJavaParse.java: In Line 23 the full path to the Jadex Config XML-File "TrikeWorld.application.xml" is needed
   • Config.java: In Line 82 the full path to the Jadex Config XML-File "TrikeWorld.application.xml" is needed

4. Create a run config with the following specifications: Java 11+, -cp eeslib, io.github.agentsoz.ees.jadexextension.masterthesis.Run.Run; program argument: --config ees/scenarios/matsim-drt-frankfurt-campus-westend-example/ees_ffm.xml

Emergency Evacuation Simulator

Dependencies

This program depends on the following projects:

• BDI-ABM Integration
• Jill BDI Engine
• Social Network Diffusion Model

Setup

Initialise and update the git submodules as below. This only has to be done once, when you first clone this repository.

git submodule update --init --recursive

How to build

mvn package

This will produce the EES release archive in ees/target/ees-x.y.z-SNAPSHOT.zip.

How to run

To run the example scenario unzip the release archive and follow the instructions provided in the packaged README.md.

Known Issues

• See GitHub Issues.

License

Emergency Evacuation Simulator Copyright (C) 2014-2020 by its authors. See ees/AUTHORS file.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses/.

For contact information, see ees/AUTHORS file.