Package FAtiMA.ReactiveComponent

Class Action

java.lang.Object

FAtiMA.ReactiveComponent.Action

All Implemented Interfaces:

FAtiMA.Core.IIntegrityTester, FAtiMA.Core.wellFormedNames.IGroundable, java.io.Serializable, java.lang.Cloneable

public class Action
extends java.lang.Object
implements FAtiMA.Core.IIntegrityTester, java.io.Serializable, FAtiMA.Core.wellFormedNames.IGroundable, java.lang.Cloneable

Represents a Reactive Action Tendency

Author:

Joao Dias

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
Action(FAtiMA.Core.wellFormedNames.Name name)	Creates a new Action (Action Tendency)

Method Summary

Modifier and Type	Method	Description
void	AddPreCondition(FAtiMA.Core.conditions.Condition cond)	Adds a precondition to the ActionTendency (that must be verified in order for the action to be executed)
void	CheckIntegrity(FAtiMA.Core.IntegrityValidator val)	Checks the integrity of the Action Tendency, it checks if the action references a SpeechAct that is not defined, in that case it throws an exception
java.lang.Object	clone()
FAtiMA.Core.emotionalState.BaseEmotion	GetElicitingEmotion()	Get's the Action Tendency's eliciting emotion
FAtiMA.Core.wellFormedNames.Name	getName()	Gets the Action's name
java.util.ArrayList<FAtiMA.Core.conditions.Condition>	GetPreconditions()
boolean	isGrounded()
void	MakeGround(FAtiMA.Core.wellFormedNames.Substitution subst)
void	MakeGround(java.util.ArrayList<FAtiMA.Core.wellFormedNames.Substitution> bindings)
void	ReinforceAction(int value)	Reinforces the likelihood of an action tendency to be activated, by lowering the minimum emotional intensity necessary to activate the AT by a given value
void	ReplaceUnboundVariables(int variableID)
void	SetElicitingEmotion(FAtiMA.Core.emotionalState.BaseEmotion emotion)	Sets the emotion that elicits this action tendency.
void	SuppressAction(int value)	Suppresses the likelihood of an action tendency to be activated, by increasing the minimum emotional intensity necessary to activate the AT by a given value
java.lang.String	toString()
FAtiMA.Core.ValuedAction	TriggerAction(FAtiMA.Core.AgentModel am, java.util.Iterator<FAtiMA.Core.emotionalState.ActiveEmotion> emotionsIterator)

Methods inherited from class java.lang.Object

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

Constructor Detail

Action

public Action(FAtiMA.Core.wellFormedNames.Name name)

Creates a new Action (Action Tendency)

Parameters:

name - - the name of the action

Method Detail

getName

public FAtiMA.Core.wellFormedNames.Name getName()

Gets the Action's name

Returns:

- the Name of the ActionTendency

GetElicitingEmotion

public FAtiMA.Core.emotionalState.BaseEmotion GetElicitingEmotion()

Get's the Action Tendency's eliciting emotion

Returns:

the BaseEmotion that may trigger the Action Tendency

GetPreconditions

public java.util.ArrayList<FAtiMA.Core.conditions.Condition> GetPreconditions()

AddPreCondition

public void AddPreCondition(FAtiMA.Core.conditions.Condition cond)

Adds a precondition to the ActionTendency (that must be verified in order for the action to be executed)

Parameters:

cond - - the Condition to add as precondition

CheckIntegrity

public void CheckIntegrity(FAtiMA.Core.IntegrityValidator val)
                    throws FAtiMA.Core.exceptions.UnknownSpeechActException

Checks the integrity of the Action Tendency, it checks if the action references a SpeechAct that is not defined, in that case it throws an exception

Specified by:

CheckIntegrity in interface FAtiMA.Core.IIntegrityTester

Throws:

FAtiMA.Core.exceptions.UnknownSpeechActException

SetElicitingEmotion

public void SetElicitingEmotion(FAtiMA.Core.emotionalState.BaseEmotion emotion)

Sets the emotion that elicits this action tendency. For example, the victim's action tendency to cry is elicited by a strong distress emotion

Parameters:

emotion - - the emotion that will elicit this action

ReinforceAction

public void ReinforceAction(int value)

Reinforces the likelihood of an action tendency to be activated, by lowering the minimum emotional intensity necessary to activate the AT by a given value

Parameters:

value - - the ammount to lower the minimum intensity

SuppressAction

public void SuppressAction(int value)

Suppresses the likelihood of an action tendency to be activated, by increasing the minimum emotional intensity necessary to activate the AT by a given value

Parameters:

value - - the ammount used to increase the minimum intensity

TriggerAction

public FAtiMA.Core.ValuedAction TriggerAction(FAtiMA.Core.AgentModel am,
                                              java.util.Iterator<FAtiMA.Core.emotionalState.ActiveEmotion> emotionsIterator)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

MakeGround

public void MakeGround(java.util.ArrayList<FAtiMA.Core.wellFormedNames.Substitution> bindings)

Specified by:

MakeGround in interface FAtiMA.Core.wellFormedNames.IGroundable

MakeGround

public void MakeGround(FAtiMA.Core.wellFormedNames.Substitution subst)

Specified by:

MakeGround in interface FAtiMA.Core.wellFormedNames.IGroundable

ReplaceUnboundVariables

public void ReplaceUnboundVariables(int variableID)

Specified by:

ReplaceUnboundVariables in interface FAtiMA.Core.wellFormedNames.IGroundable

isGrounded

public boolean isGrounded()

Specified by:

isGrounded in interface FAtiMA.Core.wellFormedNames.IGroundable

clone

public java.lang.Object clone()

Overrides:

clone in class java.lang.Object