Package org.opennars.storage

Class Memory

java.lang.Object

org.opennars.storage.Memory

All Implemented Interfaces:

Serializable, Iterable<Concept>, Resettable

public class Memory
extends Object
implements Serializable, Iterable<Concept>, Resettable

Memory consists of the run-time state of a Nar, including: * term and concept memory * reasoner state * etc.
Excluding input/output channels which are managed by a Nar.
A memory is controlled by zero or one Nar's at a given time.
Memory is serializable so it can be persisted and transported.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
boolean	allowExecution
(package private) boolean	checked
Bag<Concept,Term>	concepts
private long	currentStampSerial
Emotions	emotion
EventEmitter	event
InternalExperience	internalExperience
(package private) boolean	isjUnit
Task	lastDecision
long	narId
Parameters	narParameters
Bag<Task<Term>,Sentence<Term>>	novelTasks
Map<CharSequence,Operator>	operators
Random	randomNumber
long	randomSeed
Bag<Task<Term>,Sentence<Term>>	recent_operations
Bag<Task<Term>,Sentence<Term>>	seq_current
private Boolean	tasksMutex

Constructor Summary

Constructors

Constructor	Description
Memory(Parameters narParameters, Bag<Concept,Term> concepts, Bag<Task<Term>,Sentence<Term>> novelTasks, Bag<Task<Term>,Sentence<Term>> seq_current, Bag<Task<Term>,Sentence<Term>> recent_operations)	Create a new memory

Method Summary

Modifier and Type	Method	Description
void	addNewTask(Task t, String reason)	add new task that waits to be processed in the next cycleMemory
Operator	addOperator(Operator op)
Concept	concept(Term t)	Get an existing Concept for a given name
void	conceptRemoved(Concept c)
Concept	conceptualize(BudgetValue budget, Term term)	Get the Concept associated to a Term, or create it.
void	cycle(Nar nar)
float	cycles(double durations)	converts durations to cycles
void	emit(Class c, Object... signal)
boolean	emitting(Class channel)
void	executedTask(Timable time, Operation operation, TruthValue truth)	ExecutedTask called in Operator.call
Operator	getOperator(String op)
void	inputTask(Timable time, Task t)
void	inputTask(Timable time, Task task, boolean emitIn)	Input task processing.
static boolean	isJUnitTest()
Iterator<Concept>	iterator()
void	localInference(Task task, Parameters narParameters, Timable time)
Stamp.BaseEntry	newStampSerial()
void	output(Task t)
void	processNovelTask(Parameters narParameters, Timable time)	Select a novel task to process
Operator	removeOperator(Operator op)
void	removeTask(Task task, String reason)
void	reset()	reset

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from class java.lang.Object

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

Field Detail

narParameters

public final Parameters narParameters

narId

public long narId

emotion

public Emotions emotion

internalExperience

public InternalExperience internalExperience

lastDecision

public Task lastDecision

allowExecution

public boolean allowExecution

randomSeed

public final long randomSeed

See Also:

Constant Field Values

randomNumber

public final Random randomNumber

concepts

public final Bag<Concept,Term> concepts

event

public transient EventEmitter event

operators

public final Map<CharSequence,Operator> operators

tasksMutex

private final Boolean tasksMutex

novelTasks

public final Bag<Task<Term>,Sentence<Term>> novelTasks

seq_current

public final Bag<Task<Term>,Sentence<Term>> seq_current

recent_operations

public final Bag<Task<Term>,Sentence<Term>> recent_operations

checked

boolean checked

isjUnit

boolean isjUnit

currentStampSerial

private long currentStampSerial

Constructor Detail

Memory

public Memory(Parameters narParameters,
              Bag<Concept,Term> concepts,
              Bag<Task<Term>,Sentence<Term>> novelTasks,
              Bag<Task<Term>,Sentence<Term>> seq_current,
              Bag<Task<Term>,Sentence<Term>> recent_operations)

Create a new memory

Method Detail

reset

public void reset()

Description copied from interface: Resettable

reset

Specified by:

reset in interface Resettable

concept

public Concept concept(Term t)

Get an existing Concept for a given name

called from Term and ConceptWindow.

Parameters:

t - the name of a concept

Returns:

a Concept or null

conceptualize

public Concept conceptualize(BudgetValue budget,
                             Term term)

Get the Concept associated to a Term, or create it. Existing concept: apply tasklink activation (remove from bag, adjust budget, reinsert) New concept: set initial activation, insert Subconcept: extract from cache, apply activation, insert If failed to insert as a result of null bag, returns null A displaced Concept resulting from insert is forgotten (but may be stored in optional subconcept memory

Parameters:

term - indicating the concept

Returns:

an existing Concept, or a new one, or null

addNewTask

public void addNewTask(Task t,
                       String reason)

add new task that waits to be processed in the next cycleMemory

isJUnitTest

public static boolean isJUnitTest()

inputTask

public void inputTask(Timable time,
                      Task task,
                      boolean emitIn)

Input task processing. Invoked by the outside or inside environment. Outside: StringParser (addInput); Inside: InnateOperator (feedback).

Parameters:

time - indirection to retrieve time

task - The addInput task

inputTask

public void inputTask(Timable time,
                      Task t)

Parameters:

time - indirection to retrieve time

removeTask

public void removeTask(Task task,
                       String reason)

executedTask

public void executedTask(Timable time,
                         Operation operation,
                         TruthValue truth)

ExecutedTask called in Operator.call

Parameters:

operation - The operation just executed

time - indirection to retrieve time

output

public void output(Task t)

emit

public final void emit(Class c,
                       Object... signal)

emitting

public final boolean emitting(Class channel)

conceptRemoved

public void conceptRemoved(Concept c)

cycle

public void cycle(Nar nar)

localInference

public void localInference(Task task,
                           Parameters narParameters,
                           Timable time)

Parameters:

task - task to be processed

narParameters - parameters for the Reasoner instance

time - indirection to retrieve time

processNovelTask

public void processNovelTask(Parameters narParameters,
                             Timable time)

Select a novel task to process

Parameters:

narParameters - parameters for the Reasoner instance

time - indirection to retrieve time

getOperator

public Operator getOperator(String op)

addOperator

public Operator addOperator(Operator op)

removeOperator

public Operator removeOperator(Operator op)

newStampSerial

public Stamp.BaseEntry newStampSerial()

cycles

public final float cycles(double durations)

converts durations to cycles

iterator

public Iterator<Concept> iterator()

Specified by:

iterator in interface Iterable<Concept>