Package org.opennars.interfaces.pub

Interface Reasoner

All Superinterfaces:

Eventable, InputFileConsumer, Multistepable, NarseseConsumer, Pluggable, Resettable, SensoryChannelConsumer, TaskConsumer<Reasoner>, Timable

All Known Implementing Classes:

Nar

public interface Reasoner
extends SensoryChannelConsumer, Resettable, NarseseConsumer, InputFileConsumer, TaskConsumer<Reasoner>, Eventable, Pluggable, Multistepable, Timable

Implementations implement a full Non-axiomatic-reasoner

Author:

Robert Wünsche

Method Summary

Modifier and Type	Method	Description
Reasoner	ask(String termString, AnswerHandler answered)	ask reasoner a eternal question
Reasoner	askNow(String termString, AnswerHandler answered)	ask reasoner a now question
Concept	concept(String concept)	returns the concept by name/term or creates it if it doesn't exist
long	getMinCyclePeriodMS()	returns the minimum delay of a cycle in milliseconds
boolean	isRunning()	is the reasoner running?
void	run()	Main loop executed by the Thread.
void	setThreadYield(boolean b)	When b is true, Nar will call Thread.yield each run() iteration that minCyclePeriodMS==0 (no delay).
long	time()	return the current time from the clock

Methods inherited from interface org.opennars.interfaces.Eventable

emit, event, off, on

Methods inherited from interface org.opennars.interfaces.InputFileConsumer

addInputFile

Methods inherited from interface org.opennars.interfaces.Multistepable

cycle, cycles, start, start, stop

Methods inherited from interface org.opennars.interfaces.NarseseConsumer

addInput

Methods inherited from interface org.opennars.interfaces.Pluggable

addPlugin, getPlugins, removePlugin

Methods inherited from interface org.opennars.interfaces.Resettable

reset

Methods inherited from interface org.opennars.interfaces.SensoryChannelConsumer

addSensoryChannel

Methods inherited from interface org.opennars.interfaces.TaskConsumer

addInput

Method Detail

ask

Reasoner ask(String termString,
             AnswerHandler answered)
      throws Parser.InvalidInputException

ask reasoner a eternal question

Parameters:

termString - narsese string with term of question

answered - handler which will be called when answered

Returns:

reasoner which processes the question

Throws:

Parser.InvalidInputException

askNow

Reasoner askNow(String termString,
                AnswerHandler answered)
         throws Parser.InvalidInputException

ask reasoner a now question

Parameters:

termString - narsese string with term of question

answered - handler which will be called when answered

Returns:

reasoner which processes the question

Throws:

Parser.InvalidInputException

concept

Concept concept(String concept)
         throws Parser.InvalidInputException

returns the concept by name/term or creates it if it doesn't exist

Parameters:

concept - the name/term of the concept

Returns:

queried or created concept

Throws:

Parser.InvalidInputException

run

void run()

Main loop executed by the Thread. Should not be called directly.

time

long time()

return the current time from the clock

Specified by:

time in interface Timable

Returns:

The current time

isRunning

boolean isRunning()

is the reasoner running?

Returns:

is it running

getMinCyclePeriodMS

long getMinCyclePeriodMS()

returns the minimum delay of a cycle in milliseconds

Returns:

minimum cycle delay period

setThreadYield

void setThreadYield(boolean b)

When b is true, Nar will call Thread.yield each run() iteration that minCyclePeriodMS==0 (no delay). This is for improving program responsiveness when Nar is run with no delay.

Parameters:

b - Nar will call Thread.yield each run()