Package org.opennars.entity

Class Task<T extends Term>

java.lang.Object

org.opennars.entity.Item<Sentence<T>>

org.opennars.entity.Task<T>

All Implemented Interfaces:

Serializable

public class Task<T extends Term>
extends Item<Sentence<T>>
implements Serializable

A task to be processed, consists of a Sentence and a BudgetValue. A task references its parent and an optional causal factor (usually an Operation instance). These are implemented as WeakReference to allow forgetting via the garbage collection process. Otherwise, Task ancestry would grow unbounded, violating the assumption of insufficient resources (AIKR).

Author:

Pei Wang, Patrick Hammer

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Task.EnumType

Nested classes/interfaces inherited from class org.opennars.entity.Item

Item.ItemPriorityComparator<E extends Item>, Item.StringKeyItem

Field Summary

Fields

Modifier and Type	Field	Description
private Sentence	bestSolution
private boolean	isInput
Sentence	parentBelief
private boolean	partOfSequenceBuffer
Sentence<T>	sentence

Fields inherited from class org.opennars.entity.Item

budget

Constructor Summary

Constructors

Constructor	Description
Task(Sentence<T> s, BudgetValue b, Sentence parentBelief)	Constructors for double premise derived task
Task(Sentence<T> s, BudgetValue b, Sentence parentBelief, Sentence solution)	Constructors for solved double premise derived task
Task(Sentence<T> s, BudgetValue b, Task.EnumType type)	Constructor for input task and single premise derived task

Method Summary

Modifier and Type	Method	Description
boolean	aboveThreshold()
boolean	equals(Object obj)
Sentence	getBestSolution()	Get the best-so-far solution for a Question or Goal
long	getCreationTime()	Directly get the creation time of the sentence
Sentence	getParentBelief()	Get the parent belief of a task
T	getTerm()
int	hashCode()
boolean	isElemOfSequenceBuffer()
boolean	isInput()	Check if a Task is a direct input
Item	merge(Item that)	Merge one Task into another
Sentence	name()	Get the current key
void	setBestSolution(Memory memory, Sentence judg, Timable time)	Set the best-so-far solution for a Question or Goal, and report answer for input question
void	setElemOfSequenceBuffer(boolean b)	flag to indicate whether this Event Task participates in tempporal induction
String	toStringLong()	Get a String representation of the Task

Methods inherited from class org.opennars.entity.Item

decDurability, decPriority, getBudget, getDurability, getPriority, getPrioritySum, getQuality, incDurability, incPriority, setDurability, setPriority, setQuality, toString, toStringExternal, toStringExternal2

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

sentence

public final Sentence<T extends Term> sentence

parentBelief

public final Sentence parentBelief

bestSolution

private Sentence bestSolution

partOfSequenceBuffer

private boolean partOfSequenceBuffer

isInput

private boolean isInput

Constructor Detail

Task

public Task(Sentence<T> s,
            BudgetValue b,
            Task.EnumType type)

Constructor for input task and single premise derived task

Parameters:

s - The sentence

b - The budget

Task

public Task(Sentence<T> s,
            BudgetValue b,
            Sentence parentBelief)

Constructors for double premise derived task

Parameters:

s - The sentence

b - The budget

parentBelief - The belief used for deriving the task

Task

public Task(Sentence<T> s,
            BudgetValue b,
            Sentence parentBelief,
            Sentence solution)

Constructors for solved double premise derived task

Parameters:

s - The sentence

b - The budget

parentBelief - The belief used for deriving the task

solution - The solution to the task

Method Detail

name

public Sentence name()

Description copied from class: Item

Get the current key

Specified by:

name in class Item<Sentence<T extends Term>>

Returns:

Current key value

equals

public boolean equals(Object obj)

Overrides:

equals in class Item<Sentence<T extends Term>>

hashCode

public int hashCode()

Overrides:

hashCode in class Item<Sentence<T extends Term>>

getCreationTime

public long getCreationTime()

Directly get the creation time of the sentence

Returns:

The creation time of the sentence

isInput

public boolean isInput()

Check if a Task is a direct input

Returns:

Whether the Task is derived from another task

aboveThreshold

public boolean aboveThreshold()

merge

public Item merge(Item that)

Merge one Task into another

Overrides:

merge in class Item<Sentence<T extends Term>>

Parameters:

that - The other Task

Returns:

the resulting Item: this or that

getBestSolution

public Sentence getBestSolution()

Get the best-so-far solution for a Question or Goal

Returns:

The stored Sentence or null

setBestSolution

public void setBestSolution(Memory memory,
                            Sentence judg,
                            Timable time)

Set the best-so-far solution for a Question or Goal, and report answer for input question

Parameters:

judg - The solution to be remembered

getParentBelief

public Sentence getParentBelief()

Get the parent belief of a task

Returns:

The belief from which the task is derived

toStringLong

public String toStringLong()

Get a String representation of the Task

Overrides:

toStringLong in class Item<Sentence<T extends Term>>

Returns:

The Task as a String

setElemOfSequenceBuffer

public void setElemOfSequenceBuffer(boolean b)

flag to indicate whether this Event Task participates in tempporal induction

isElemOfSequenceBuffer

public boolean isElemOfSequenceBuffer()

getTerm

public T getTerm()