org.jactr.core.module.declarative.four.learning

Class DefaultDeclarativeLearningModule4

java.lang.Object

org.jactr.core.utils.DefaultAdaptable

org.jactr.core.module.AbstractModule

org.jactr.core.module.declarative.four.learning.DefaultDeclarativeLearningModule4

All Implemented Interfaces:

IDeclarativeLearningModule4, IModule, ILearningModule, IAdaptable, IInitializable, IInstallable, IParameterized

Direct Known Subclasses:

DefaultDeclarativeLearningModule6

public class DefaultDeclarativeLearningModule4
extends AbstractModule
implements IDeclarativeLearningModule4, IParameterized

default declarative learning module. learning is accomplished by attaching listeners to chunks and buffers. For instance, we attach a listener to all chunks so we know when they are accessed (used for base level learning). we also listen to all slot changes so that associative links can be adjusted accordingly. And we listen to the procedural module so that we know which production fired, binding to which chunks so that the associative links can be updated

Author:

developer

See Also:

http://jactr.org/node/128}

Field Summary

Fields

Modifier and Type	Field and Description
protected double	_associativeLearningRate
protected IBaseLevelActivationEquation	_baseLevelActivationEquation
protected double	_baseLevelLearningRate
protected IModelListener	_modelListener this model listener will allow us to perform learning asynchronously, but block until the current batch of learning is complete before running the next cycle.
protected int	_optimizationLevel

Fields inherited from interface org.jactr.core.module.declarative.four.learning.IDeclarativeLearningModule4

ASSOCIATIVE_LEARNING_RATE, BASE_LEVEL_LEARNING_RATE, OPTIMIZED_LEARNING

Constructor Summary

Constructors

Constructor and Description
DefaultDeclarativeLearningModule4()

Method Summary

Modifier and Type	Method and Description
protected DefaultAssociativeLinkageSystem	createAssociativeLinkageSystem()
protected IBaseLevelActivationEquation	createBaseLevelActivationEquation()
protected IDeclarativeModuleListener	createDeclarativeListener()
void	dispose() release any resources.
double	getAssociativeLearning()
IBaseLevelActivationEquation	getBaseLevelActivationEquation()
double	getBaseLevelLearning()
int	getOptimizationLevel()
java.lang.String	getParameter(java.lang.String key) return parameter value - null if not defined.
java.util.Collection<java.lang.String>	getPossibleParameters() Return all parameters that can be read
java.util.Collection<java.lang.String>	getSetableParameters() Return list of all parameters that can be set.
void	initialize() called after all the chunks are in place.
void	install(IModel model) called from the model during IModel.install(IModule).
boolean	isAssociativeLearningEnabled()
boolean	isBaseLevelLearningEnabled()
boolean	isLearningEnabled()
void	reset() reset the module.
void	setAssociativeLearning(double learningRate)
void	setBaseLevelActivationEquation(IBaseLevelActivationEquation equation)
void	setBaseLevelLearning(double learningRate)
void	setLearningEnabled(boolean enable)
void	setOptimizationLevel(int level)
void	setParameter(java.lang.String key, java.lang.String value) Set the named parameter

Methods inherited from class org.jactr.core.module.AbstractModule

createBuffers, delayedFuture, delayedFuture, getExecutor, getModel, getName, getSafeName, immediateFuture, immediateReturn, setExecutor, uninstall

Methods inherited from class org.jactr.core.utils.DefaultAdaptable

addAdapterFactory, getAdapter, removeAdapterFactory

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jactr.core.module.IModule

getModel, getName

Methods inherited from interface org.jactr.core.utils.IInstallable

uninstall

Methods inherited from interface org.jactr.core.utils.IAdaptable

getAdapter

Field Detail

_optimizationLevel

protected int _optimizationLevel

_baseLevelLearningRate

protected double _baseLevelLearningRate

_associativeLearningRate

protected double _associativeLearningRate

_baseLevelActivationEquation

protected IBaseLevelActivationEquation _baseLevelActivationEquation

_modelListener

protected IModelListener _modelListener

this model listener will allow us to perform learning asynchronously, but block until the current batch of learning is complete before running the next cycle.

Constructor Detail

DefaultDeclarativeLearningModule4

public DefaultDeclarativeLearningModule4()

Method Detail

initialize

public void initialize()

called after all the chunks are in place.

Specified by:

initialize in interface IModule

Specified by:

initialize in interface IInitializable

Specified by:

initialize in class AbstractModule

install

public void install(IModel model)

Description copied from interface: IModule

called from the model during IModel.install(IModule). The module should handle any nondependent initialization here. Since no chunks will have been installed yet, the module should make not attempt to make reference to any until just before the model runs. Likewise, you should not install listeners into modules that this one is dependent upon until initialize() is called.

Specified by:

install in interface IModule

Specified by:

install in interface IInstallable

Overrides:

install in class AbstractModule

See Also:

IInstallable.install(org.jactr.core.model.IModel)

createDeclarativeListener

protected IDeclarativeModuleListener createDeclarativeListener()

createBaseLevelActivationEquation

protected IBaseLevelActivationEquation createBaseLevelActivationEquation()

createAssociativeLinkageSystem

protected DefaultAssociativeLinkageSystem createAssociativeLinkageSystem()

dispose

public void dispose()

Description copied from interface: IModule

release any resources. this should only be called by the model during its own dispose method (assuming that this module is still installed) and should not result in the propogation of ANY events. The module should dispose of all its resources, including buffers

Specified by:

dispose in interface IModule

Overrides:

dispose in class AbstractModule

getOptimizationLevel

public int getOptimizationLevel()

Specified by:

getOptimizationLevel in interface IDeclarativeLearningModule4

setOptimizationLevel

public void setOptimizationLevel(int level)

getAssociativeLearning

public double getAssociativeLearning()

Specified by:

getAssociativeLearning in interface IDeclarativeLearningModule4

Returns:

getBaseLevelLearning

public double getBaseLevelLearning()

Specified by:

getBaseLevelLearning in interface IDeclarativeLearningModule4

Returns:

isAssociativeLearningEnabled

public boolean isAssociativeLearningEnabled()

Specified by:

isAssociativeLearningEnabled in interface IDeclarativeLearningModule4

Returns:

isBaseLevelLearningEnabled

public boolean isBaseLevelLearningEnabled()

Specified by:

isBaseLevelLearningEnabled in interface IDeclarativeLearningModule4

Returns:

setAssociativeLearning

public void setAssociativeLearning(double learningRate)

setBaseLevelLearning

public void setBaseLevelLearning(double learningRate)

isLearningEnabled

public boolean isLearningEnabled()

Specified by:

isLearningEnabled in interface ILearningModule

setLearningEnabled

public void setLearningEnabled(boolean enable)

Specified by:

setLearningEnabled in interface ILearningModule

getBaseLevelActivationEquation

public IBaseLevelActivationEquation getBaseLevelActivationEquation()

Specified by:

getBaseLevelActivationEquation in interface IDeclarativeLearningModule4

See Also:

IDeclarativeLearningModule4.getBaseLevelActivationEquation()

setBaseLevelActivationEquation

public void setBaseLevelActivationEquation(IBaseLevelActivationEquation equation)

See Also:

org.jactr.core.module.declarative.four.learning.IDeclarativeLearningModule4#setBaseLevelActivationEquation(org.jactr.core.module.declarative.four.IBaseLevelActivationEquation)

getParameter

public java.lang.String getParameter(java.lang.String key)

Description copied from interface: IParameterized

return parameter value - null if not defined.

Specified by:

getParameter in interface IParameterized

Parameters:

key - Description of the Parameter

Returns:

The parameter value

See Also:

IParameterized.getParameter(java.lang.String)

getPossibleParameters

public java.util.Collection<java.lang.String> getPossibleParameters()

Description copied from interface: IParameterized

Return all parameters that can be read

Specified by:

getPossibleParameters in interface IParameterized

Returns:

The possibleParameters value

See Also:

IParameterized.getPossibleParameters()

getSetableParameters

public java.util.Collection<java.lang.String> getSetableParameters()

Description copied from interface: IParameterized

Return list of all parameters that can be set.

Specified by:

getSetableParameters in interface IParameterized

Returns:

The setableParameters value

See Also:

IParameterized.getSetableParameters()

setParameter

public void setParameter(java.lang.String key,
                         java.lang.String value)

Description copied from interface: IParameterized

Set the named parameter

Specified by:

setParameter in interface IParameterized

See Also:

IParameterized.setParameter(java.lang.String, java.lang.String)

reset

public void reset()

Description copied from interface: IModule

reset the module. This will typically clear the owned buffers and abort any module specific operations

Specified by:

reset in interface IModule