Concept (OpenNARS 3.0.4-SNAPSHOT API)

java.lang.Object
- org.opennars.entity.Item<Term>
- - org.opennars.entity.Concept

All Implemented Interfaces:

Serializable
```
public class Concept
extends Item<Term>
implements Serializable
```
Concept as defined by the NARS-theory Concepts are used to keep track of interrelated sentences

Author:

Pei Wang, Patrick Hammer

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class Concept.AnticipationEntry
- Nested classes/interfaces inherited from class org.opennars.entity.Item
  Item.ItemPriorityComparator<E extends Item>, Item.StringKeyItem

Nested Classes
Modifier and Type	Class	Description
`static class`	`Concept.AnticipationEntry`

Field Summary

Fields
Modifier and Type	Field	Description
`float`	`acquiredQuality`
`boolean`	`allowBabbling`
`List<Concept.AnticipationEntry>`	`anticipations`
`List<Task>`	`beliefs`	Judgments directly made about the term Use List because of access and insertion in the middle
`List<Task>`	`desires`	Desire values on the term, similar to the above one
`List<Task>`	`executable_preconditions`
`List<Task>`	`general_executable_preconditions`
`Memory`	`memory`	Reference to the memory to which the Concept belongs
`boolean`	`observable`
`List<Task>`	`questions`	Pending Question directly asked about the term Note: since this is iterated frequently, an array should be used.
`List<Task>`	`quests`	Pending Quests to be answered by new desire values
`List<Float>`	`recent_intervals`
`Bag<Task<Term>,Sentence<Term>>`	`seq_before`
`Bag<TaskLink,Task>`	`taskLinks`	Task links for indirect processing
`Term`	`term`	The term is the unique ID of the concept
`Bag<TermLink,TermLink>`	`termLinks`	Term links between the term and its components and compounds; beliefs
`List<TermLink>`	`termLinkTemplates`	Link templates of TermLink, only in concepts with CompoundTerm Templates are used to improve the efficiency of TermLink building

Fields inherited from class org.opennars.entity.Item
budget

Constructor Summary

Constructors
Constructor Description

Concept(BudgetValue b, Term tm, Memory memory)
Constructor, called in Memory.getConcept only

Constructors
Constructor	Description
`Concept(BudgetValue b, Term tm, Memory memory)`	Constructor, called in Memory.getConcept only

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`addToTable(Task task, boolean rankTruthExpectation, List<Task> table, int max, Class eventAdd, Class eventRemove, Object... extraEventArguments)`
`static Task`	`addToTable(Task newTask, List<Task> table, int capacity, boolean rankTruthExpectation)`	Add a new belief (or goal) into the table Sort the beliefs/desires by rank, and remove redundant or low rank one
`void`	`buildTermLinks(BudgetValue taskBudget, Parameters narParameters)`	Recursively build TermLinks between a compound and its components
`void`	`discountConfidence(boolean onBeliefs)`
`boolean`	`equals(Object obj)`
`Sentence`	`getBelief(DerivationContext nal, Task task)`	Select a isBelief to interact with the given task in inference
`List<Task>`	`getBeliefs()`	returns unmodifidable collection wrapping beliefs
`TruthValue`	`getDesire()`	Get the current overall desire value.
`List<Task>`	`getDesires()`	returns unmodifidable collection wrapping beliefs
`float`	`getQuality()`	Recalculate the quality of the concept [to be refined to show extension/intension balance]
`List<Task>`	`getQuess()`
`List<Task>`	`getQuestions()`	Return the questions, called in ComposionalRules in dedConjunctionByQuestion only
`Term`	`getTerm()`
`List<TermLink>`	`getTermLinkTemplates()`	Return the templates for TermLinks, only called in Memory.continuedProcess
`int`	`hashCode()`
`void`	`incAcquiredQuality()`
`protected boolean`	`insertTaskLink(TaskLink taskLink, DerivationContext nal)`	Insert a TaskLink into the TaskLink bag
`boolean`	`insertTermLink(TermLink termLink)`	Insert a TermLink into the TermLink bag
`TaskLink`	`linkToTask(Task task, DerivationContext content)`	Link to a new task from all relevant concepts for continued processing in the near future for unspecified time.
`Term`	`name()`	Get the current key
`Symbols.NativeOperator`	`operator()`
`void`	`returnTermLink(TermLink termLink)`
`Task`	`selectCandidate(Task query, List<Task> list, Timable time)`	Select a belief value or desire value for a given query
`TermLink`	`selectTermLink(TaskLink taskLink, long time, Parameters narParameters)`	Replace default to prevent repeated inference, by checking TaskLink
`String`	`toString()`	Return a string representation of the concept, called in ConceptBag only
`private String`	`toStringIfNotNull(Object item, String title)`
`String`	`toStringLong()`	called from `Shell`

Methods inherited from class org.opennars.entity.Item
decDurability, decPriority, getBudget, getDurability, getPriority, getPrioritySum, incDurability, incPriority, merge, setDurability, setPriority, setQuality, toStringExternal, toStringExternal2

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - term
```
public final Term term
```
    The term is the unique ID of the concept
  - seq_before
```
public Bag<Task<Term>,Sentence<Term>> seq_before
```
  - taskLinks
```
public final Bag<TaskLink,Task> taskLinks
```
    Task links for indirect processing
  - termLinks
```
public final Bag<TermLink,TermLink> termLinks
```
    Term links between the term and its components and compounds; beliefs
  - termLinkTemplates
```
public final List<TermLink> termLinkTemplates
```
    Link templates of TermLink, only in concepts with CompoundTerm Templates are used to improve the efficiency of TermLink building
  - questions
```
public final List<Task> questions
```
    Pending Question directly asked about the term Note: since this is iterated frequently, an array should be used. To avoid iterator allocation, use .get(n) in a for-loop
  - quests
```
public final List<Task> quests
```
    Pending Quests to be answered by new desire values
  - beliefs
```
public final List<Task> beliefs
```
    Judgments directly made about the term Use List because of access and insertion in the middle
  - executable_preconditions
```
public List<Task> executable_preconditions
```
  - general_executable_preconditions
```
public List<Task> general_executable_preconditions
```
  - desires
```
public final List<Task> desires
```
    Desire values on the term, similar to the above one
  - memory
```
public final Memory memory
```
    Reference to the memory to which the Concept belongs
  - recent_intervals
```
public final List<Float> recent_intervals
```
  - observable
```
public boolean observable
```
  - allowBabbling
```
public boolean allowBabbling
```
  - anticipations
```
public List<Concept.AnticipationEntry> anticipations
```
  - acquiredQuality
```
public float acquiredQuality
```
- Constructor Detail
  - Concept
```
public Concept(BudgetValue b,
               Term tm,
               Memory memory)
```
    Constructor, called in Memory.getConcept only
    
    Parameters:
    
    tm - A term corresponding to the concept
    
    memory - A reference to the memory
- Method Detail
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Item<Term>
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Item<Term>
  - name
```
public Term name()
```
    Description copied from class: Item
    
    Get the current key
    
    Specified by:
    
    name in class Item<Term>
    
    Returns:
    
    Current key value
  - addToTable
```
public void addToTable(Task task,
                       boolean rankTruthExpectation,
                       List<Task> table,
                       int max,
                       Class eventAdd,
                       Class eventRemove,
                       Object... extraEventArguments)
```
  - linkToTask
```
public TaskLink linkToTask(Task task,
                           DerivationContext content)
```
    Link to a new task from all relevant concepts for continued processing in the near future for unspecified time.
    The only method that calls the TaskLink constructor.
    
    Parameters:
    
    task - The task to be linked
    
    content - The content of the task
  - addToTable
```
public static Task addToTable(Task newTask,
                              List<Task> table,
                              int capacity,
                              boolean rankTruthExpectation)
```
    Add a new belief (or goal) into the table Sort the beliefs/desires by rank, and remove redundant or low rank one
    
    Parameters:
    
    table - The table to be revised
    
    capacity - The capacity of the table
    
    Returns:
    
    whether table was modified
  - selectCandidate
```
public Task selectCandidate(Task query,
                            List<Task> list,
                            Timable time)
```
    Select a belief value or desire value for a given query
    
    Parameters:
    
    query - The query to be processed
    
    list - The list of beliefs or desires to be used
    
    Returns:
    
    The best candidate selected
  - insertTaskLink
```
protected boolean insertTaskLink(TaskLink taskLink,
                                 DerivationContext nal)
```
    Insert a TaskLink into the TaskLink bag
    called only from Memory.continuedProcess
    
    Parameters:
    
    taskLink - The termLink to be inserted
  - buildTermLinks
```
public void buildTermLinks(BudgetValue taskBudget,
                           Parameters narParameters)
```
    Recursively build TermLinks between a compound and its components
    called only from Memory.continuedProcess
    
    Parameters:
    
    taskBudget - The BudgetValue of the task
  - insertTermLink
```
public boolean insertTermLink(TermLink termLink)
```
    Insert a TermLink into the TermLink bag
    called from buildTermLinks only
    
    Parameters:
    
    termLink - The termLink to be inserted
  - toString
```
public String toString()
```
    Return a string representation of the concept, called in ConceptBag only
    
    Overrides:
    
    toString in class Item<Term>
    
    Returns:
    
    The concept name, with taskBudget in the full version
  - toStringLong
```
public String toStringLong()
```
    called from Shell
    
    Overrides:
    
    toStringLong in class Item<Term>
  - toStringIfNotNull
```
private String toStringIfNotNull(Object item,
                                 String title)
```
  - incAcquiredQuality
```
public void incAcquiredQuality()
```
  - getQuality
```
public float getQuality()
```
    Recalculate the quality of the concept [to be refined to show extension/intension balance]
    
    Overrides:
    
    getQuality in class Item<Term>
    
    Returns:
    
    The quality value
  - getTermLinkTemplates
```
public List<TermLink> getTermLinkTemplates()
```
    Return the templates for TermLinks, only called in Memory.continuedProcess
    
    Returns:
    
    The template get
  - getBelief
```
public Sentence getBelief(DerivationContext nal,
                          Task task)
```
    Select a isBelief to interact with the given task in inference
    get the first qualified one
    only called in RuleTables.reason
    
    Parameters:
    
    task - The selected task
    
    Returns:
    
    The selected isBelief
  - getDesire
```
public TruthValue getDesire()
```
    Get the current overall desire value. TODO to be refined
  - selectTermLink
```
public TermLink selectTermLink(TaskLink taskLink,
                               long time,
                               Parameters narParameters)
```
    Replace default to prevent repeated inference, by checking TaskLink
    
    Parameters:
    
    taskLink - The selected TaskLink
    
    time - The current time
    
    Returns:
    
    The selected TermLink
  - returnTermLink
```
public void returnTermLink(TermLink termLink)
```
  - getQuestions
```
public List<Task> getQuestions()
```
    Return the questions, called in ComposionalRules in dedConjunctionByQuestion only
  - getQuess
```
public List<Task> getQuess()
```
  - discountConfidence
```
public void discountConfidence(boolean onBeliefs)
```
  - operator
```
public Symbols.NativeOperator operator()
```
  - getTerm
```
public Term getTerm()
```
  - getBeliefs
```
public List<Task> getBeliefs()
```
    returns unmodifidable collection wrapping beliefs
  - getDesires
```
public List<Task> getDesires()
```
    returns unmodifidable collection wrapping beliefs

Class Concept

Nested Class Summary

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

Field Summary

Fields inherited from class org.opennars.entity.Item

Constructor Summary

Method Summary

Methods inherited from class org.opennars.entity.Item

Methods inherited from class java.lang.Object

Field Detail

term

seq_before

taskLinks

termLinks

termLinkTemplates

questions

quests

beliefs

executable_preconditions

general_executable_preconditions

desires

memory

recent_intervals

observable

allowBabbling

anticipations

acquiredQuality

Constructor Detail

Concept

Method Detail

equals

hashCode

name

addToTable

linkToTask

addToTable

selectCandidate

insertTaskLink

buildTermLinks

insertTermLink

toString

toStringLong

toStringIfNotNull

incAcquiredQuality

getQuality

getTermLinkTemplates

getBelief

getDesire

selectTermLink

returnTermLink

getQuestions

getQuess

discountConfidence

operator

getTerm

getBeliefs

getDesires