COGENT Version 2.3 Help



A buffer is an information store. It is a place where information can be put for later retrieval. Buffers are appropriate for both short term storage (as in modelling working memory, for example) and long term storage (as in large knowledge bases). They can be configured, through sub-classes and properties, so as to behave in a variety of different ways (allowing, for example, decay of elements or capacity restrictions).

A stack is a kind of buffer that provides very limited access to its ordered elements. The elements of a stack are ordered in the sequence in which those elements were added to the stack. Access to the stack is only allowed through the most recent or "top" element of the stack. There are basically three operations which may be performed on a stack: the top-most element may be matched; an element may be "pushed" onto the top of the stack (thus obscuring the previous top element); and an element may be popped off the top of the stack (thus revealing a previously hidden element). One common use of stacks is in maintaining sequences of goals and sub-goals, as, for example, in models of problem solving. They also have common uses in processing of syntax.

Despite the flexibility of COGENT's standard propositional buffer type, instances of the type cannot be used to implement a stack. Firstly, only the top-most element may be accessed in a real stack, but a propositional buffer, even with LIFO access, still allows access to all buffer elements. Secondly, elements can be deleted from any position within a propositional buffer, whereas only the top-most element can be deleted from a stack (and this operation is known as a pop). Thirdly, when multiple elements are added to a propositional buffer on the same cycle, COGENT provides no guarantee about the order in which those elements will be added. The stack buffer type provides a storage mechanism that addresses each of these issues.

Stack Messages

Like all buffers, stacks can be matched by the conditions of rules. However, a stack match will only match against the top-most element of the stack.

An element may be pushed onto a stack by sending the stack a message of the form push(Element). The top-most element may be popped from a stack by sending the stack a message of the form pop. Thus, the RHS of a rule which pops the top element off Goal Stack and replaces it with sub-goal might look like:

If multiple push and/or pop messages are sent to the same stack from the RHS of one rule, then those push/pop messages are processed in the order in which they appear on the RHS of the rule. If multiple push and/or pop messages are sent to the same stack from multiple rules, then messages within the same rule will be processed in order, but the order of processing of messages from different rules is not deterministic.

This use of the ordering of stack related actions within rules differs from standard rule processing. In general, the ordering of rule actions does not affect the order of execution of those actions: non-stack related "send" actions are effectively processed in parallel.

Stack Buffer Properties

Like all COGENT buffers, stacks have an initialisation property which specifies when they are initialised (e.g., at the beginning of each trial or block). Stacks typically have an unlimited capacity, but COGENT allows the capacity of a stack to be fixed (using the standard buffer capacity limitation properties). COGENT also allows the specification of actions to be taken when stack capacity is reached. Two further properties specify whether stack elements can decay, and, if so, the rate of that decay. Unlike propositional buffers, there is no Duplicates property and no Access property.

Initialise (possible values: Each Trial/Each Block/Each Subject/Each Experiment/Each Session; default: Each Trial)
The timing of buffer initialisation is determined by this property. When the value is Each Trial, the buffer will automatically initialise itself at the beginning of each trial. When the value is Each Block, the buffer will initialise itself at the beginning of each block of trials (i.e., contents will be preserved across trials within a block). Similarly, when the value is Each Subject, contents will be preserved across simulated blocks, when the value is Each Experiment, contents will be preserved across simulated subjects, and when the value is Each Session, the contents will be preserved across experiment.

Limited Capacity (possible values: on/off; default: off)
This property determines whether the buffer has limited or unlimited capacity. If the value is Yes then the buffer's capacity is limited to the value specified by the Capacity property, and its behaviour when that capacity is exceeded is governed by the On Excess property; if the value is No, these two properties are ignored.

Capacity (possible values: 1 -- 9999; default: 7)
This property specifies the capacity of a buffer in terms of the number of items it may hold. If Limited Capacity is not selected, this property has no effect.

On Excess (possible values: Random/Youngest/Oldest/Ignore; default: Random)
The value of this property determines how the buffer behaves when its capacity is exceeded. If the value is Random, then a random element will be deleted from the buffer to make way for the new element. If the value is Youngest, then the most recently added element will be deleted to make way for the new element. If the value is Oldest, then the least recently added element will be deleted to make way for the new element. If the value is Ignore, then the new element will be discarded and the buffer contents will not be altered. If Limited Capacity is not selected, this property has no effect.

Decay (possible values: None/Probabilistic/Fixed; default: None)
This property specifies whether the elements of a buffer decay with time, and if so what pattern of decay is observed. When the value is None, elements will remain in a buffer until they are either explicitly deleted or are forced out by the buffer overflowing. When the value is Probabilistic, elements decay in a random fashion, but with the probability of decay begin constant on each cycle. This probability is specified in terms of a half life (specified by the Decay Constant property). The half life is the number of cycles it takes on average for half of the elements to decay. When the value is Fixed, elements remain in the buffer for a fixed number of cycles (specified by the Decay Constant property).

Decay Constant (possible values: 1 -- 9999; default: 20)
This property determines the decay rate if decay is specified for the buffer. In the case of Probabilistic decay, the constant specifies the half-life (in cycles) of buffer elements. A larger number will result in a longer half-life and so a slower decay. In the case of Fixed decay, the constant specifies the number of cycles an element will remain present in the buffer after the element is added to the buffer (provided it is not ``refreshed'' via Duplicates: No, as discussed above). Again, a larger number will lead to slower decay.

Grounded (Boolean; default: TRUE)
If this property is set, attempts to add ungrounded terms (i.e., terms containing variables) to the buffer will result in an error message. The rationale for this property is that in most applications adding ungrounded terms to a buffer is probably results from a bug in the model, so flagging such occurrences is useful. In some applications, however, it may be reasonable to have ungrounded terms in buffers (e.g., where the terms represent production-like rules). In these cases, the property should not be set.

The Stack View

The current contents of stack buffers may be viewed in text mode or in a graphical mode. In the text mode, the elements in the stack are displayed with the top-most element at the top of the text view. In graphical mode, the stack is displayed pictorially, with an arrow pointing to the top-most element. When the model is running, both of these views are updated whenever the current contents change.

If, when printing, Show current contents? is selected, then the text and graphical views of the current stack state are included in the print out.

The Buffer Element Editor

Recall that all information must be represented in COGENT via Prolog terms. Buffer elements are no exception, but they are perhaps the simplest sorts of box elements in COGENT. This is reflected in the simplicity of the buffer element editor. Apart from the comment line, it contains a single text field into which the buffer element should be typed. The contents of this field should be a valid Prolog term. If not, however, COGENT does automatic syntax checking (and attempted correction) of editor elements, and so any error will be noted and (possibly) corrected.

COGENT Version 2.3 Help