Package org.tweetyproject.agents

Class MultiAgentSystem<T extends Agent>

java.lang.Object

org.tweetyproject.agents.MultiAgentSystem<T>

Type Parameters:

T - the agent class.

All Implemented Interfaces:

Iterable<T>, Collection<T>

Direct Known Subclasses:

GroundedGameSystem, LotteryGameSystem, StructuredArgumentationSystem

public class MultiAgentSystem<T extends Agent>
extends Object
implements Collection<T>

A multi-agent system is a collection of agents with some environment.

Author:

Matthias Thimm

Field Summary

Fields

Modifier and Type	Field	Description
static final int	EXECUTE_TILL_TERMINATION	Indicates that the execution of this system's protocol should be repeated until it has terminated.

Constructor Summary

Constructors

Constructor	Description
MultiAgentSystem(Environment environment)	Creates a new empty multi-agent system with the given environment.
MultiAgentSystem(Environment environment, Collection<? extends T> agents)	Creates a new multi-agent system with the given collection of agents.

Method Summary

Modifier and Type	Method	Description
boolean	add(T e)
boolean	addAll(Collection<? extends T> c)
void	clear()
boolean	contains(Object o)
boolean	containsAll(Collection<?> c)
boolean	equals(Object obj)
void	execute(AbstractProtocol protocol)	Executes the given protocol till it terminates.
boolean	execute(AbstractProtocol protocol, int numOfSteps)	Executes the given protocol for the given number of steps.
Environment	getEnvironment()	Returns the environment of this multi-agent system.
int	hashCode()
boolean	isEmpty()
Iterator<T>	iterator()
boolean	remove(Object o)
boolean	removeAll(Collection<?> c)
boolean	retainAll(Collection<?> c)
int	size()
Object[]	toArray()
<S> S[]	toArray(S[] a)

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, removeIf, spliterator, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Field Details

EXECUTE_TILL_TERMINATION

public static final int EXECUTE_TILL_TERMINATION

Indicates that the execution of this system's protocol should be repeated until it has terminated.

See Also:

• Constant Field Values

Constructor Details

MultiAgentSystem

public MultiAgentSystem(Environment environment)

Creates a new empty multi-agent system with the given environment.

Parameters:

environment - some environment.

MultiAgentSystem

public MultiAgentSystem(Environment environment,
 Collection<? extends T> agents)

Creates a new multi-agent system with the given collection of agents.

Parameters:

agents - a collection of agents.

environment - some environment.

Method Details

getEnvironment

public Environment getEnvironment()

Returns the environment of this multi-agent system.

Returns:

the environment of this multi-agent system.

execute

public boolean execute(AbstractProtocol protocol,
 int numOfSteps)
                throws ProtocolTerminatedException,
IllegalArgumentException

Executes the given protocol for the given number of steps. Set steps to Protocol.EXECUTE_TILL_TERMINATION to have the protocol executed till termination.

Parameters:

protocol - a protocol.

numOfSteps - the number of steps to be executed.

Returns:

"true" if the protocol has terminated after executing the given number of steps.

Throws:

ProtocolTerminatedException - if the protocol terminates before all steps could be executed.

IllegalArgumentException - if the given number of steps is zero or negative and not equal to Protocol.EXECUTE_TILL_TERMINATION.

execute

public void execute(AbstractProtocol protocol)
             throws ProtocolTerminatedException

Executes the given protocol till it terminates.

Parameters:

protocol - a protocol.

Throws:

ProtocolTerminatedException - if the protocol has already terminated.

add

public boolean add(T e)

Specified by:

add in interface Collection<T extends Agent>

addAll

public boolean addAll(Collection<? extends T> c)

Specified by:

addAll in interface Collection<T extends Agent>

clear

public void clear()

Specified by:

clear in interface Collection<T extends Agent>

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<T extends Agent>

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<T extends Agent>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<T extends Agent>

iterator

public Iterator<T> iterator()

Specified by:

iterator in interface Collection<T extends Agent>

Specified by:

iterator in interface Iterable<T extends Agent>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<T extends Agent>

removeAll

public boolean removeAll(Collection<?> c)

Specified by:

removeAll in interface Collection<T extends Agent>

retainAll

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<T extends Agent>

size

public int size()

Specified by:

size in interface Collection<T extends Agent>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<T extends Agent>

toArray

public <S> S[] toArray(S[] a)

Specified by:

toArray in interface Collection<T extends Agent>

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<T extends Agent>

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Specified by:

equals in interface Collection<T extends Agent>

Overrides:

equals in class Object