clarion.system
Class GoalAction

java.lang.Object
  extended by java.util.AbstractMap<K,V>
      extended by java.util.HashMap<K,V>
          extended by java.util.LinkedHashMap<java.lang.Object,Dimension>
              extended by clarion.system.DimensionValueCollection
                  extended by clarion.system.AbstractChunk
                      extended by clarion.system.AbstractOutputChunk
                          extended by clarion.system.AbstractAction
                              extended by clarion.system.GoalAction
All Implemented Interfaces:
InterfaceStochasticallySelectable, InterfaceTracksTime, java.io.Serializable, java.lang.Cloneable, java.util.Map<java.lang.Object,Dimension>

public class GoalAction
extends AbstractAction

This class implements a goal action within CLARION. It extends the AbstractAction class.

Usage:

A goal action is an action that is performed internally by CLARION to set, reset, or remove goals from the goal structure.

An action chunk is attached to the output layer of the bottom level implicit modules in the ACS as well as to rules on the top level. Actions are not required to have dimension-value pairs, but it is advised they be provided as they act as the "instructions" that dictate how an action is to be performed.

Activated values within the action chunk indicate the parts of the action that should be performed. Non-activated values in the action chunk are used to specify those components that should NOT be performed. Therefore, both activation and non-activation of values provide important information for how to handle the action.

Currently, goal actions are delivered to the task environment in which the agent exists and it is the user's responsibility to handle the directives of the goal action. However, in future versions of this Library, the performing of these actions will be internalized.

Version:
6.0.4
Author:
Nick Wilson
See Also:
Serialized Form

Field Summary
private  int hash
          The hash for this object.
private static long serialVersionUID
           
 
Fields inherited from class clarion.system.AbstractOutputChunk
C, D, FULL_ACTIVATION_LEVEL, GLOBAL_C, GLOBAL_D, GLOBAL_FULL_ACTIVATION_LEVEL, GLOBAL_INITIAL_BLA, GLOBAL_MINIMUM_ACTIVATION_THRESHOLD, GLOBAL_PERSISTENCE, INITIAL_BLA, MINIMUM_ACTIVATION_THRESHOLD, PERSISTENCE
 
Constructor Summary
GoalAction(java.lang.Object id)
          Initializes the goal action with the ID specified.
GoalAction(java.lang.Object id, java.util.Collection<? extends Dimension> dims)
          Initializes the goal action with the specified ID and dimensions.
GoalAction(java.lang.Object id, java.util.Map<? extends java.lang.Object,? extends Dimension> dims)
          Initializes the goal action with the specified ID and map of dimensions.
 
Method Summary
 GoalAction clone()
          Clones the goal action (including all of it's dimensions).
 int hashCode()
           
 
Methods inherited from class clarion.system.AbstractAction
put, putAll
 
Methods inherited from class clarion.system.AbstractOutputChunk
addTimeStamp, adjustSelectionMeasure, getActivation, getBLA, getBLSelectionMeasure, getFinalSelectionMeasure, getTLSelectionMeasure, resetActivation, setActivation, setBLSelectionMeasure, setFinalSelectionMeasure, setTLSelectionMeasure
 
Methods inherited from class clarion.system.AbstractChunk
equals, equalsID, getID, toString
 
Methods inherited from class clarion.system.DimensionValueCollection
containsKeys, getNumDVPairs, getValueCollection, size
 
Methods inherited from class java.util.LinkedHashMap
clear, containsValue, get, removeEldestEntry
 
Methods inherited from class java.util.HashMap
containsKey, entrySet, isEmpty, keySet, remove, values
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.util.Map
containsKey, entrySet, isEmpty, keySet, remove, values
 

Field Detail

serialVersionUID

private static final long serialVersionUID
See Also:
Constant Field Values

hash

private int hash
The hash for this object. When this item is cloned, so is this hash.

Constructor Detail

GoalAction

public GoalAction(java.lang.Object id)
Initializes the goal action with the ID specified.

Parameters:
id - The ID of the goal action.

GoalAction

public GoalAction(java.lang.Object id,
                  java.util.Collection<? extends Dimension> dims)
Initializes the goal action with the specified ID and dimensions.

Parameters:
id - The ID of the goal action.
dims - The dimensions for the goal action.

GoalAction

public GoalAction(java.lang.Object id,
                  java.util.Map<? extends java.lang.Object,? extends Dimension> dims)
Initializes the goal action with the specified ID and map of dimensions.

Parameters:
id - The ID of the goal action.
dims - The map of dimensions for the goal action.
Method Detail

hashCode

public int hashCode()
Specified by:
hashCode in interface java.util.Map<java.lang.Object,Dimension>
Overrides:
hashCode in class DimensionValueCollection

clone

public GoalAction clone()
Clones the goal action (including all of it's dimensions).

Specified by:
clone in class AbstractAction
Returns:
A copy of the goal action.