mod_record

From Sohatex CRIISTAL Wiki
Jump to: navigation, search

This module provides recorder functionality to save measured and calculated values to disk.

Description

RecorderConfig.png

This is the configuration window for the module, which can be opened by clicking the Recording > Recorder Configuration menu item.

With the dropdown list [1] choose between currently defined recorders. To add a recorder, use the Add button [2]. To remove one, select it and click the Remove button [3]. To rename the selected recorder press the properties button [4].

After adding a recorder the path the recorder saves to [5], a filename prefix [6], the recording frequenzy in Hz [7] and the recording duration in sec [8] can be changed. After starting the recorder the recorder records until the recording duration [8] is reached or the stop button [18] is pressed. If the duration time is set to "Inf" the recorder records until he is stopped by clicking the stop button [18].

If the restart LED control [9] is active the recorder restarts every time after the recording duration is over until the stop button [18] is pressed.

The recorded files can be of "Tabstop-Text" or "TDMS" file format [10].

The "Type" dropdown-list [11] defines either recording "Mean Values" or "Current Values". In case of "Mean Values" one line with mean values is written to the same file every time the recorder was active. The mean value filename consists only of the filename prefix defined in [6]. In case of "Current Value" the recorder writes a line for every time that is defined at "Frequency" [7] to the same file. After restarting the recorder a new file will be created. The current value filename consists of the filename prefix and an added number that counts up each time the recorder was started (e.g.: Record.012.txt)

The "Trigger-Output Variable" [12] defines a variable which has the value "1" if the recorder is active and "0" if the recorder is inactive.

The "Record Variables" list [13] shows the variables that will be recorded. To add variables simple drag&drop them from the variable list. To remove one, select it and press del on the keyboard.

To add an absolute timestamp to the recorded file activate the "Add absolute timestamp" LED [14]. To add an relative timestamp to the recorded file activate the "Add relative timestamp" LED [15].

The status field [19] shows some record information. The current runtime, the recorded lines and the current/last filename.

The "Suppress Mean Calculation (use latest value instead) for" list [20] defines variables where instead of the mean value the latest measured value is written to the file, if record type [11] is "Mean Values".

With the buttons "Start" [17] and "Stop" [18] the recorder can be started or stopped.

File structure

The recorded file is structured in the following way:

absolute timestamp (optional [14]) relative timestamp (optional [15]) Name of variable 1 Name of variable 2 ... Name of variable X
Description of absolute timestamp (optional [16]) Description of relative timestamp (optional [16]) Description of variable 1 (optional [16]) Description of variable 2 (optional [16]) ... Description of variable X (optional [16])
unit of absolute timestamp (optional [16]) unit of relative timestamp (optional [16]) unit of variable 1 (optional [16]) unit of variable 2 (optional [16]) ... unit of variable X (optional [16])
data data data data ... data
data data data data ... data
... ... ... ... ... ...
data data data data ... data