COGENT Online
CONTENTS
COGENT Version 2.3 Help

Data/Sink/Text

Introduction

Data sinks are generally used to catch the output of a model. There are three forms of data sink: text-based sinks (described here), tabular sinks and graph sinks. In the case of text-based sinks, messages sent to the sink are added to the end of data sink's contents file, together with an index showing the cycle number when the message was received. Initialisation clears the data sink's output file and inserts a data stamp.

As with other COGENT boxes, there is no limit to the number of data sinks you can have in one model, and multiple data sinks will behave as independent devices.

Properties

All data sinks have three properties:

Initialise (possible values: Each Trial/Each Block/Each Subject/Each Experiment/Each Session; default: Each Trial)
This property determines the timing of data sink initialisation. When the value is Each Trial, the data sink will automatically initialise itself at the beginning of each trial. When the value is Each Block, initialisation will only occur at the beginning of each block. Hence, elements will accumulate in the data sink across trials, but not across blocks. Analogous comments apply when the initialisation level is set at each subject, experiment or session.

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.


COGENT Online
CONTENTS
COGENT Version 2.3 Help