zeus.actors.rtn.util
Class GraphStruct

java.lang.Object
  zeus.actors.rtn.util.GraphStruct

All Implemented Interfaces:

java.lang.Cloneable

public class GraphStruct

extends java.lang.Object

implements java.lang.Cloneable

This is the primary coordination structure. One is created for each goal at the start of a coordination process, and maintained until the end of the planning/contracting process.

Field Summary

java.lang.String	agent If agentA contracts a task out to another agentB, then gs.agent for agentB will point to agentA.
java.lang.Object	any A temporary structure for holding miscellaneous information.
boolean	confirmed If agentA contracts a task out to another agentB, then gs.confirmed for agentB indicates whether agentA has confirmed the contract or not.
java.util.Vector	confirmed_goal If agentA contracts a task out to another agentB, then gs.confirmed_goal for agentB will contain the final goal agreed to by agentB and confirmed by agentA.
java.util.Vector	d_results A vector containing the results of a delegation round
java.util.Hashtable	decompositions A structure containing summary task decomposition information that is utilised during planning.
StrategyEvaluatorList	evaluators A list of all StrategyEvaluators participating in the contracting process for the goal.
java.util.Vector	external A vector of subgoals of the root that need to be delegated/contracted out.
java.util.Vector	goal A vector containing the root goal
java.util.Vector	ignore_agents The list of agents to ignore, i.e. not to attempt contracting the goal out to.
java.util.Vector	internal A vector containing subgoals of the root goal that the agent can perform on its own.
java.lang.String	key The contract reference.
java.util.Vector	selection A vector of DelegationStructs of from agents whose proposals will be accepted.
double	timeout The amount of time availabe for the contracting process.

Constructor Summary

GraphStruct()

GraphStruct(java.lang.String agent, Goal g)

GraphStruct(java.lang.String agent, Goal g, java.lang.String key)

GraphStruct(java.lang.String agent, Goal g, java.lang.String key, java.util.Vector internal, java.util.Vector external)

GraphStruct(java.lang.String agent, java.lang.String key, java.util.Vector goals)

GraphStruct(java.lang.String agent, java.util.Vector goal)

Method Summary

GraphStruct	duplicate()
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

goal

public java.util.Vector goal

A vector containing the root goal

internal

public java.util.Vector internal

A vector containing subgoals of the root goal that the agent can perform on its own.

external

public java.util.Vector external

A vector of subgoals of the root that need to be delegated/contracted out.

d_results

public java.util.Vector d_results

A vector containing the results of a delegation round

selection

public java.util.Vector selection

A vector of DelegationStructs of from agents whose proposals will be accepted.

confirmed

public boolean confirmed

If agentA contracts a task out to another agentB, then gs.confirmed for agentB indicates whether agentA has confirmed the contract or not.

agent

public java.lang.String agent

If agentA contracts a task out to another agentB, then gs.agent for agentB will point to agentA.

key

public java.lang.String key

The contract reference.

any

public java.lang.Object any

A temporary structure for holding miscellaneous information.

timeout

public double timeout

The amount of time availabe for the contracting process.

ignore_agents

public java.util.Vector ignore_agents

The list of agents to ignore, i.e. not to attempt contracting the goal out to.

confirmed_goal

public java.util.Vector confirmed_goal

If agentA contracts a task out to another agentB, then gs.confirmed_goal for agentB will contain the final goal agreed to by agentB and confirmed by agentA. This goal might contain additional information such references to agents that will be provide resources to agentB so that it can achieve the goal.

decompositions

public java.util.Hashtable decompositions

A structure containing summary task decomposition information that is utilised during planning.

evaluators

public StrategyEvaluatorList evaluators

A list of all StrategyEvaluators participating in the contracting process for the goal.

For example, assume a goal g0 decomposes into two external subgoals g1 and g2. Now an attempt is made to contract out g1 to agents B and C, and g2 to agent D, E, F. In this case, we will have 5 strategy evaluators, one for each subgoal/agent combination. The shared strategy evaluator list allows one evaluator to consider the status of other evaluators when making bidding decisions. (Note: No implemented example to date has utilised the cross-evaluator dialogue feature).

Constructor Detail

GraphStruct

public GraphStruct()

GraphStruct

public GraphStruct(java.lang.String agent,
                   Goal g)

GraphStruct

public GraphStruct(java.lang.String agent,
                   Goal g,
                   java.lang.String key)

GraphStruct

public GraphStruct(java.lang.String agent,
                   Goal g,
                   java.lang.String key,
                   java.util.Vector internal,
                   java.util.Vector external)

GraphStruct

public GraphStruct(java.lang.String agent,
                   java.util.Vector goal)

GraphStruct

public GraphStruct(java.lang.String agent,
                   java.lang.String key,
                   java.util.Vector goals)

Method Detail

toString

public java.lang.String toString()

duplicate

public GraphStruct duplicate()