Add query_percept to get list of all agents in an area

BDI-ABM Integration Package

master dev

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:

Dhirendra Singh, Lin Padgham, Kai Nagel. Using MATSim as a Component in Dynamic Agent-Based Micro-Simulations International Workshop on Engineering Multi-Agent Systems (EMAS), pages 85-105, 2019.
Dhirendra Singh, Lin Padgham, Brian Logan. Integrating BDI agents with Agent Based Simulation Platforms. Autonomous Agents and Multi-agent Systems 30, pages 1050–1071, 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 (ECAI) 263, 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

Bushfire example

See examples/bushfire/README.md.

Conservation Example

Build the bdi-abm-integration layer: In the source repository /, do mvn clean install -N
Build the BDI-ABM library: See /integrations/bdi-abm/README.md for instructions
Build the BDI-GAMS library: See /integrations/bdi-gams/README.md for instructions
Build the ABM-Jill library: See /integrations/abm-jill/README.md for instructions
Build the Conservation application: In /examples/conservation, do mvn clean install

Vaccination Example (probably outdated as of 11/Sep/2018)

Build the bdi-abm-integration layer: In the source repository /, do mvn clean install -N
Build the BDI-ABM library: See /integrations/bdi-abm/README.md for instructions
Build the ABM-JACK library: See /integrations/abm-jack/README.md for instructions
Build the Bushfire application: In /examples/vaccination, do mvn clean install

License

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 AUTHORS file.

	<simulation
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="https://github.com/agentsoz/bdi-abm-integration"
	xsi:schemaLocation="https://github.com/agentsoz/bdi-abm-integration ../../xsd/main.xsd">

	<firefile>
	<name>scenarios/mount-alexander-shire/maldon-600/scenario_fire.json</name>
	<coordinates>latlong</coordinates>
	<format>geojson</format>
	</firefile>

	<firefile>
	<name>scenarios/mount-alexander-shire/maldon-600/scenario_fire.json</name>
	<coordinates>latlong</coordinates>
	<format>geojson</format>
	</firefile>

	<coordinateSystem>latlong</coordinateSystem>

	<destinations>
	<location>
	<name>Harcourt</name>
	<coordinates>255934.018201,5901133.6543</coordinates>
	<split>80</split>
	</location>

	"disruptions" : [
	{
	"description" : "Road blocked near -38.528634, 143.943352 due to fallen tree",
	"startHHMM" : "0000",
	"endHHMM" : "0200",
	"effectiveSpeed" : "0",
	"effectiveSpeedUnit" : "KMPH",
	"impactedLinks" : ["89174", "89175"]
	}
	]

	CoordinateTransformation transform = TransformationFactory.getCoordinateTransformation(
	TransformationFactory.WGS84, scenario.getConfig().global().getCoordinateSystem());

	before_install:
	- cd $HOME && git clone --depth=1 --branch=kaibranch https://github.com/matsim-org/matsim.git
	- cd $HOME/matsim && git checkout kaibranch && git log -1
	- cd $HOME/matsim/examples && mvn clean install -DskipTests -Dmaven.test.skip -Dmaven.javadoc.skip -Dsource.skip -Dassembly.skipAssembly=true
	- cd $HOME/matsim/matsim && mvn clean install -DskipTests -Dmaven.test.skip -Dmaven.javadoc.skip -Dsource.skip -Dassembly.skipAssembly=true
	- cd $HOME && git clone --depth=1 --branch=dev https://github.com/agentsoz/jill.git
	- cd $HOME/jill && git checkout dev && git log -1
	- cd $HOME/jill && mvn clean install -N
	- cd $HOME/jill/jill && mvn clean install

	Resident,
	home,EvacZone
	work,Business District,Caravan Park,Hotel,Golf Club
	beach,Beach
	shops,Shops
	other,University,Secondary,Tafe,Kindergarten,Primary

Time	Evacuation Zone(s)	Message	Destination	Via
10:00:00	Aireys Inlet Region	Advice		-
10:30:00	Aireys Inlet Region	Watch and Act	-	-
11:00:00	Aireys Inlet Region	Evacuate	Torquay Place of Congregation	Anglesea

	static void penaltyMethod2(Geometry fire, Geometry buffer, double bufferWidth,
	Map<Id<Link>, Double> penaltyFactorsOfLinks, Scenario scenario ) {
	// Starting thoughts:
	// * Could make everything very expensive in buffer + fire, they find the fastest path out. This may, however,
	// be through the fire.
	// * Could make everything very expensive in fire, and factor of 10 less expensive in buffer. Then they would
	// find fastest way out of fire, then fastest way out of buffer.
	// * Problem is that fastest way out of buffer may entail getting or remaining close to the fire.
	//
	// What about

	# Extract the travel time of agents (in minutes)
	zcat $experienced_plans_file \| grep -o 'route type="links".trav_time=. distance' \| cut -f3 -d' ' \| cut -f2 -d'"' \| awk -F':' '{printf "%.1f\n", ($1*60 + $2 + $3/60)}' > $traveltime_file.csv

	// FIXME: differences in number of arrivals when replanning with congestion; dsingh 2/feb/18
	/*
	final String actualEventsFilename = utils.getOutputDirectory() + "/output_events.xml.gz";
	long actualEventsCRC = CRCChecksum.getCRCFromFile( actualEventsFilename ) ;
	log.warn("actual(events)="+actualEventsCRC) ;
	long actualPlansCRC = CRCChecksum.getCRCFromFile( utils.getOutputDirectory() + "/output_plans.xml.gz" ) ;
	log.warn("actual(plans)="+actualPlansCRC) ;

	final String primaryExpectedEventsFilename = utils.getInputDirectory() + "/output_events.xml.gz";
	TestUtils.comparingDepartures(primaryExpectedEventsFilename,actualEventsFilename,1.);
	TestUtils.comparingArrivals(primaryExpectedEventsFilename,actualEventsFilename,1.);
	TestUtils.comparingActivityStarts(primaryExpectedEventsFilename,actualEventsFilename, 1.);
	TestUtils.compareFullEvents(primaryExpectedEventsFilename,actualEventsFilename, true);

	long [] expectedPlans = new long [] {
	CRCChecksum.getCRCFromFile( utils.getInputDirectory() + "/output_plans.xml.gz" )
	};
	TestUtils.checkSeveral(expectedPlans, actualPlansCRC);
	*/

agentsoz / bdi-abm-integration Goto Github PK

bdi-abm-integration's Introduction

BDI-ABM Integration Package

How to use this software

Build Dependencies

Compiling

Bushfire example

Conservation Example

Vaccination Example (probably outdated as of 11/Sep/2018)

License

bdi-abm-integration's People

Contributors

Stargazers

Watchers

Forkers

bdi-abm-integration's Issues

Greetings

Fire data

Location data

MATSim CRS

Recommend Projects

Recommend Topics

Recommend Org

Jobs