Package net.sf.tweety.agents
Class MultiAgentSystem<T extends Agent>
- java.lang.Object
-
- net.sf.tweety.agents.MultiAgentSystem<T>
-
- Type Parameters:
T
- the agent class.
- All Implemented Interfaces:
java.lang.Iterable<T>
,java.util.Collection<T>
- Direct Known Subclasses:
GroundedGameSystem
,LotteryGameSystem
,StructuredArgumentationSystem
public class MultiAgentSystem<T extends Agent> extends java.lang.Object implements java.util.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 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, java.util.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(java.util.Collection<? extends T> c)
void
clear()
boolean
contains(java.lang.Object o)
boolean
containsAll(java.util.Collection<?> c)
boolean
equals(java.lang.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()
java.util.Iterator<T>
iterator()
boolean
remove(java.lang.Object o)
boolean
removeAll(java.util.Collection<?> c)
boolean
retainAll(java.util.Collection<?> c)
int
size()
java.lang.Object[]
toArray()
<S> S[]
toArray(S[] a)
-
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, toString, wait, wait, wait
-
-
-
-
Field Detail
-
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 Detail
-
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, java.util.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 Detail
-
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, java.lang.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.java.lang.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.
-
addAll
public boolean addAll(java.util.Collection<? extends T> c)
-
contains
public boolean contains(java.lang.Object o)
-
containsAll
public boolean containsAll(java.util.Collection<?> c)
-
isEmpty
public boolean isEmpty()
-
iterator
public java.util.Iterator<T> iterator()
-
remove
public boolean remove(java.lang.Object o)
-
removeAll
public boolean removeAll(java.util.Collection<?> c)
-
retainAll
public boolean retainAll(java.util.Collection<?> c)
-
toArray
public java.lang.Object[] toArray()
-
toArray
public <S> S[] toArray(S[] a)
-
hashCode
public int hashCode()
-
-