Bushfire Example

Application using JACK-MATsim integration

License	License GNU General Lesser Public License, Version 3.0
GroupId	GroupId io.github.agentsoz
ArtifactId	ArtifactId bushfire
Last Version	Last Version 2.0.1
Release Date	Release Date Mar 24, 2017
Type	Type jar
Description	Description Bushfire Example Application using JACK-MATsim integration

Download bushfire

Filename	Size
bushfire-2.0.1.pom
bushfire-2.0.1.jar	467 KB
bushfire-2.0.1-sources.jar	241 KB
bushfire-2.0.1-javadoc.jar	710 KB
bushfire-2.0.1-bin.zip	46 MB
Browse

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.agentsoz/bushfire/ -->
<dependency>
    <groupId>io.github.agentsoz</groupId>
    <artifactId>bushfire</artifactId>
    <version>2.0.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.agentsoz/bushfire/
implementation 'io.github.agentsoz:bushfire:2.0.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.agentsoz/bushfire/
implementation ("io.github.agentsoz:bushfire:2.0.1")

Apache Buildr

'io.github.agentsoz:bushfire:jar:2.0.1'

Apache Ivy

<dependency org="io.github.agentsoz" name="bushfire" rev="2.0.1">
  <artifact name="bushfire" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.agentsoz', module='bushfire', version='2.0.1')
)

Scala SBT

libraryDependencies += "io.github.agentsoz" % "bushfire" % "2.0.1"

Leiningen

[io.github.agentsoz/bushfire "2.0.1"]

Dependencies

compile (12)

Group / Artifact	Type	Version
com.aosgrp » jack	jar	5.6
io.github.agentsoz : bdi-abm	jar	2.0.1
io.github.agentsoz : abm-jack	jar	2.0.1
io.github.agentsoz : abm-jill	jar	2.0.1
io.github.agentsoz : bdi-matsim	jar	2.0.1
com.google.code.gson : gson	jar	2.3.1
log4j : log4j	jar	1.2.17
com.googlecode.json-simple : json-simple	jar	1.1
jfree : jfreechart	jar	1.0.13
jfree : jcommon	jar	1.0.15
io.github.agentsoz : util	jar	2.0.1
ch.qos.logback : logback-classic	jar	1.0.13

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

BDI-ABM Integration Package

This software realises a mechanism for integrating Belief-Desire-Intention (BDI) reasoning into agents within an agent-based simulation (ABM). The concept is described in the following papers papers:

Dhirendra Singh, Lin Padgham, Brian Logan. Integrating BDI agents with Agent Based Simulation Platforms. Autonomous Agents and Multi-agent Systems, 2016.
Lin Padgham, Dhirendra Singh. Making MATSim Agents Smarter with the Belief-Desire-Intention Framework Horni, A., Nagel, K. and Axhausen, K.W. (eds.) The Multi-Agent Transport Simulation MATSim, pages 201-210, 2016. Ubiquity Press London.
Lin Padgham, Kai Nagel, Dhirendra Singh, Qingyu Chen. Integrating BDI Agents into a MATSim Simulation. Frontiers in Artificial Intelligence and Applications 263 (ECAI 2014), pages 681-686, 2014.

How to use this software

Examples of BDI-ABM applications are provided in the ./examples directory.

Any BDI-ABM application consists of three layers. A generic first layer (./integrations/bdi-abm) manages the high level interaction and message passing between the BDI and the ABM system. A second platform specific layer realises the connection between a specific BDI platform (such as JACK, i.e., ./integrations/abm-jack), and a specific ABM system (such as MATSim, i.e., ./integrations/bdi-matsim). Finally, a third application layer puts these together along with domain specific code (for instance `./examples/bushfire).

Overall, the repository consists of integrations and examples. Integrations are platform specific and live in ./integrations. Examples are domain specific, and live in ./examples. The following integrations are provided:

Integration	Directory	Description
BDI-ABM	`./integrations/bdi-abm`	BDI-ABM communication and data layer
BDI-GAMS	`./integrations/bdi-gams`	Integration for GAMS (www.gams.com)
BDI-MATSim	`./integrations/bdi-matsim`	Integration for MATSim (www.matsim.org)
ABM-JACK	`./integrations/abm-jack`	Integration for JACK (aosgrp.com/products/jack)
ABM-Jill	`./integrations/abm-jill`	Integration for Jill (http://agentsoz.github.io/jill)
ABM-Jadex	`./integrations/abm-jadex`	Integration for Jadex (http://www.activecomponents.org/bin/view/About/Features)

Integrations are pulled together to build application examples. The following examples are provided:

Example	Directory	Description
Bushfire	`./examples/bushfire`	Uses Jill and MATSim
Bushfire Tutorial	`./examples/bushfire-tutorial`	Uses JACK and MATSim
Conservation Ethics	`./examples/conservation`	Uses Jill and GAMS
Child Vaccination	`./examples/vaccination`	Uses JACK and a custom Python-based ABM

In addition to above, the repository consists of an util project. It lives in ./util and contains the utility classes used by integration libraries and example applications in the repository.

Project	Directory	Description
Util	`./util`	Contains utility classes for integration libraries and example applications

Build Dependencies

Java Development Kit 1.8 http://en.wikipedia.org/wiki/Java_Development_Kit
Apache Maven 3.3.* http://maven.apache.org
Some of the integrations (e.g., JACK, GAMS) require third-party libraries to be installed in your local Maven repository. See the respective READMEs (./integrations/*/README.md) for details. The project will not build unless these dependencies have been resolved.

Compiling