Recording

This element controls recording modes and DMD storage and split settings.

All attributes expecting a time duration have to be specified as scalar values using the unit “s” (seconds).

<Recording [stopAfter="scalar"]>
    [<WaveformRecording .../>]
    [<StatisticsRecording .../>]
    [<DMDSettings .../>]
</Recording>

stopAfter: If this attribute is used, the measurement ends automatically after the specified time

<WaveformRecording>

<WaveformRecording [mode="string|continuous"] [preTime="scalar"] [postTime="scalar" | pauseAfter="scalar"]/>

mode: Defines how raw samples are recorded:

  • continuous: Record the entire measurement

  • triggered: Record based on the recording actions configured in the <Triggering> element

  • disabled: Do not store waveform data at all

preTime, postTime, pauseAfter: These settings are only useful in triggered mode. If any of these attributes are specified, the corresponding setting is actived using the specified parameter. Only one of postTime or pauseAfter may be used.

<StatisticsRecording>

<StatisticsRecording [mode="string|disabled"] [window="scalar|1s"]/>

mode: Defines how statistical data is recorded:

  • continuous: Record the entire measurement

  • disabled: Do not store statistical data at all

window: Defines the statistical window length in seconds.

<DMDSettings>

<DMDSettings [namePattern="string"] [outputPath="string"]>
    [
    <SplitByDuration interval="scalar"/>
    |
    <SplitByNumberOfEvents count="positive_integer"/>
    ]
</DMDSettings>

WARNING: The following two options will be stored globally and remain in use even after OXYGEN is restarted! The current OXYGEN settings are used, if the attributes are not specfied.

namePattern: Describes how the dmd filename(s) will be constructed.

outputPath: The absolute path where output files will be created. By default, a subdirectory will be used, if the file split feature is used.

One of the SplitBy elements may be specified as a child to enable the associated functionality.

  • SplitByDuration: Start a new file after interval seconds of data was stored.

  • SplitByNumberOfEvents: Start a new file after count number of recording events were stored.