COGENT Online
CONTENTS
COGENT Version 2.4 Help

Data/Sink/Table

Introduction

Data sinks are generally used to catch the output of a model. There are three forms of data sink: text-based sinks, tabular sinks (described here) and graph sinks. In the case of tabular sinks, messages are interpreted as table entries, and the sink's contents are automatically displayed as a table.

There is no limit to the number of tabular data sinks you can have in one model, and multiple tabular data sinks will behave as independent devices.

Messages

Tabular data sinks expect to receive messages of the form:

data(Row, Col, Value)

Such messages are interpreted as indicating that the table entry indexed by the values of Row and Col is Value. This new value will supersede any previous value associated with Row and Col.

Properties

Tabular data sinks have seven properties that control their behaviour and appearance:

Initialise (possible values: Each Trial/Each Block/Each Subject/Each Experiment/Each Session; default: Each Trial)
This property controls re-initialising (i.e., clearing) of data sink contents.

Location [values: Local/IO Directory; default: Local]
This property specifies the location of output files. Data sink output may be stored either locally (with the definition of the sink), or in COGENT's standard OOS I/O directory/folder, from where it may be retrieved (e.g., for inclusion in a document).

File [values: an arbitrary character string]
This property specifies the name of the output file in which data is stored. It is possible to capture data from different runs of the same model in different output files. The property is most useful when the Location property is set to IO Directory.

Column Label: [values: an arbitrary character string; default: "Columns"]
The value of this property is used as the label for the table's columns when the table is viewed in "Current State (Table)" mode.

Row Label: [values: an arbitrary character string; default: "Rows"]
The value of this property is used as the label for the table's rows when the table is viewed in "Current State (Table)" mode.

Cell Width: [values: a positive integer; default: 70]
The value of this property specifies the width of each column (in pixels) when the table is viewed in "Current State (Table)" mode.

Cell Height: [values: a positive integer: default: 25]
The value of this property specifies the height of each row (in pixels) when the table is viewed in "Current State (Table)" mode.

Sort (possible values: Alpha/Reverse Alpha/Primacy/Recency; default: Alpha)
This property is used when drawing the table to determine the order of rows and columns. When it is set to Alpha, for example, rows and columns are ordered alphabetically by row/column labels, whereas when it is set to Primacy rows and columns are ordered with the first created row/column at the top left, and the last created row/column at the bottom right.

The Table View

Tabular data sinks may be viewed as tables by selecting the appropriate view from their Mode menu. Each element is used to construct an entry within a row and column labelled with the values of Row and Col for which the element was specified. The standard printing procedures may be used to print these tables.


COGENT Online
CONTENTS
COGENT Version 2.4 Help