br.unicamp.cst.behavior.asbac

Class AffordanceType

java.lang.Object

br.unicamp.cst.behavior.asbac.AffordanceType

public abstract class AffordanceType
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
AffordanceType(java.lang.String affordanceName, double minCost, double maxCost, AffordanceType parent, int level)

Method Summary

Modifier and Type	Method and Description
void	addChild(AffordanceType childAffordance)
void	addRelevantPerceptCategory(java.lang.String relevantPerceptCategory, java.lang.String perceptCategory)
abstract double	calculateExecutionCost(java.util.Map<java.lang.String,Percept> relevantPercepts) Compute the cost to realize the affordance.
abstract double	computeAffordanceTypeBenefit(java.util.Map<java.lang.String,java.util.List<Percept>> situation, java.util.Map<java.lang.String,Percept> relevantPercepts) Compute the benefit of this affordance type to current situation.
abstract double	computeParametersBenefit(java.util.Map<java.lang.String,java.util.List<Percept>> situation, java.util.Map<java.lang.String,Percept> relevantPercepts) Compute the percepts' benefits for the current situation.
double	getActionMaxCost()
double	getActionMinCost()
java.lang.String	getAffordanceName()
java.util.List<AffordanceType>	getChildren() Get the list of affordances types that can turn this affordance possible.
int	getLevel() Get the level of this AffordanceType in its hierarchy.
AffordanceType	getParent() Get the parent of this AffordanceType in its hierarchy.
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getRelevantPerceptsCategories()
abstract boolean	isExecutable(java.util.Map<java.lang.String,Percept> relevantPercepts) Define if this affordance is executable for the actual context.
abstract boolean	isRelevantPercept(Percept percept) Define if a percept is relevant for the affordance.
double	normalize(double value, double max, double min)

Methods inherited from class java.lang.Object

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

Constructor Detail

AffordanceType

public AffordanceType(java.lang.String affordanceName,
                      double minCost,
                      double maxCost,
                      AffordanceType parent,
                      int level)

Method Detail

getAffordanceName

public java.lang.String getAffordanceName()

getActionMinCost

public double getActionMinCost()

getActionMaxCost

public double getActionMaxCost()

getParent

public AffordanceType getParent()

Get the parent of this AffordanceType in its hierarchy.

Returns:

a shallow AffordanceType.

getChildren

public java.util.List<AffordanceType> getChildren()

Get the list of affordances types that can turn this affordance possible.

Returns:

a shallow list of AffordanceType.

getLevel

public int getLevel()

Get the level of this AffordanceType in its hierarchy.

Returns:

a int.

getRelevantPerceptsCategories

public java.util.Map<java.lang.String,java.util.List<java.lang.String>> getRelevantPerceptsCategories()

addChild

public void addChild(AffordanceType childAffordance)

addRelevantPerceptCategory

public void addRelevantPerceptCategory(java.lang.String relevantPerceptCategory,
                                       java.lang.String perceptCategory)

normalize

public double normalize(double value,
                        double max,
                        double min)

isExecutable

public abstract boolean isExecutable(java.util.Map<java.lang.String,Percept> relevantPercepts)

Define if this affordance is executable for the actual context.

Parameters:

relevantPercepts -

Returns:

a boolean.

isRelevantPercept

public abstract boolean isRelevantPercept(Percept percept)

Define if a percept is relevant for the affordance. For each types of percepts relevant to affordance, it is necessary specify conditions based on relevant percepts' properties.

Parameters:

percept -

Returns:

a boolean.

calculateExecutionCost

public abstract double calculateExecutionCost(java.util.Map<java.lang.String,Percept> relevantPercepts)

Compute the cost to realize the affordance.

Parameters:

relevantPercepts -

Returns:

a double representing the cost.

computeAffordanceTypeBenefit

public abstract double computeAffordanceTypeBenefit(java.util.Map<java.lang.String,java.util.List<Percept>> situation,
                                                    java.util.Map<java.lang.String,Percept> relevantPercepts)

Compute the benefit of this affordance type to current situation.

Parameters:

situation -

relevantPercepts -

Returns:

a double representing the benefit.

computeParametersBenefit

public abstract double computeParametersBenefit(java.util.Map<java.lang.String,java.util.List<Percept>> situation,
                                                java.util.Map<java.lang.String,Percept> relevantPercepts)

Compute the percepts' benefits for the current situation.

Parameters:

situation -

relevantPercepts -

Returns:

a double representing the benefit.