Triggered Events

*Trigger Events* Menu – Overview

Fig. 392 Trigger Events Menu – Overview

OXYGEN provides two different recording modes: The Waveform Recording and the Statistics Recording.

The Waveform Recording stores all channels that are enabled for recording @full sample rate into the data file.

The Statistics Recording stores only the statistical values MIN, MAX, AVG and RMS of an adjustable time window between 0.1 and 10 seconds into the data file. The Statistics Recording is also only done for the input channels that are enabled for recording.

Both recording modes can be enabled independently. The default software setting enables both Continuous Waveform Recording and Statistics Recording (Statistics window: 1 second).

If the user does not want OXYGEN to enable Waveform Recording for the complete recording time but only when certain input signal levels are reached, he can control that with the Event Based Waveform Recording (=Triggering) which is explained in the following sections.

Event Based Waveform Recording and Statistics Recording

A very useful combination is the Event Based Waveform Recording in combination with the Statistics Recording. Especially over long measurement periods with rare trigger events, the Statistics Recording gives the user the guarantee that data was recorded without consuming much hard disk space. In the data file, the waveform data is plotted when the trigger event was active and otherwise the MIN and MAX value of the Statistics Recording data (see Fig. 393).

*Event Based Waveform* Recording (marked in red) and enabled *Statistics* Recording

Fig. 393 Event Based Waveform Recording (marked in red) and enabled Statistics Recording

Automatic Measurement Start

OXYGEN offers the possibility to start the measurement automatically after the software has started. To activate the Automatic measurement start, enlarge the Triggered Events menu to the full screen and check Start measurement automatically in the Advanced Settings (see Fig. 394).

Triggered Events menu, Automatic measurement start

Fig. 394 Triggered Events menu, Automatic measurement start

In case of Continuous Waveform Recording (refer to Triggered Events), the measurement will start automatically after OXYGEN has started and makes the manual press of the Recording button obsolete (see ⑧ in Fig. 10).

As DEWETRON measurement systems start automatically after they are connected to a power supply, the measurement can start automatically after the measurement system is powered without any interaction of the user. OXYGEN must be added to the Windows Autostart applications for this procedure.

In case of Event based Waveform Recording (refer to Triggered Events and Record Action), the measurement will start automatically when the Start Recording condition (see Record Action) is active. Therefore, it is not necessary to arm the trigger manually anymore (see Arming the Trigger).

Adding a Trigger Event

Enable Trigger Mode

Fig. 395 Enable Trigger Mode

If the Event Based Recording is activated, the user must add one or several Trigger Events that regulate the recording start. This can be done via the +Add Event button (see Fig. 395). Optionally the user can also store the data before the trigger event was reached by adding a Pre-time between 0 and 10 seconds and he can also define a time after which the record is stopped automatically again (Stop after).

Adding an Event Condition

After an event was added, the user must define an event condition and assign a data channel that is surveilled by the event condition:

Define an Event Condition and Trigger on *Level HIGH*

Fig. 396 Define an Event Condition and Trigger on Level HIGH

The channel to be triggered on can be selected from the channel list on the right screen side (see ① in Fig. 396). The user can select between five different event conditions (see ② in Fig. 396):

  • Level HIGH: Activate Event if selected signal exceeds defined Threshold. A Rearm Level that must be passed before the trigger is activated again can optionally be defined (see ③ in Fig. 396).

  • Level LOW: Activate Event if selected signal falls below defined Threshold. A Rearm Level that must be passed before the trigger is activated again can optionally be defined (see Fig. 397).

    Trigger on *Level LOW*

    Fig. 397 Trigger on Level LOW

  • Window IN: Activate Event if selected signal is within a certain range. The user can define an upper and a lower limit (see Fig. 398).

    Trigger on *Window IN*

    Fig. 398 Trigger on Window IN

  • Window OUT: Activate Event if selected signal is out of a certain range. The user can define an upper and a lower limit (see Fig. 399).

    Trigger on *Window OUT*

    Fig. 399 Trigger on Window OUT

  • Keyboard Event: Control Trigger via the keyboard. The user can select two different states: True while hold activates the Event if the selected key is pressed and Toggle when pressed toggles between activating and deactivating the Event every time the button is pressed. The key can be selected with a click on the field right to Shortcut. In this example, the Space key was selected.

    Trigger on *Keyboard* Event

    Fig. 400 Trigger on Keyboard Event

  • Time Event: The event is activated in the dependency of a time condition. In the example in Fig. 401, the event is activated every 30 minutes for a duration of 1 minute. If the Active for option is not enabled, the Event will be active for one Sample interval, i.e. for 1 ms if the sample Rate is 1 kHz. The red indicator (see ① in Fig. 402) won’t highlight if the Active for option is not enabled.

    Trigger on *Time* Event

    Fig. 401 Trigger on Time Event

Note

  • The red indicator shows if the respective event is active or not (see ① in Fig. 402)

  • The blue switch deactivates the event permanently (see ② in Fig. 402)

  • The deletes the event (see ③ in Fig. 402)

  • It is possible to add several Event Conditions to the same event

Trigger Menu - Additional information

Fig. 402 Trigger Menu - Additional information

Adding an Event Action

After the Event Condition is configured the user must define an action that shall be performed when the event is activated, the Event Action. Four different actions are available: A Record action, an Alarm action, a Marker action and a Snapshot action. Each action has a submenu with different possibilities that are explained in the following sections.

Note

It is possible to add several Event Actions to the same Event

Record Action

Trigger - Recording Actions

Fig. 403 Trigger - Recording Actions

  • Start Recording: Starts the recording mode when the event is activated

  • Pause Recording: Pauses the recording mode when the event is activated

  • Record Event: Recording is enabled if the event is active

  • Toggle Recording: Toggles recording status if the event is activated

Alarm Action

Trigger - Alarm Actions

Fig. 404 Trigger - Alarm Actions

  • Add marker on Alarm: A marker will be set when the event is activated

  • Digital out – HIGH on alarm: The status of a digital out channel will be set to High when the Event is activated. The channel(s) can be selected from the channel list on the right-hand side. An automatic reset of the channel after 0 - 3600 seconds can optionally be selected.

  • Digital out – LOW on alarm: The status of a digital out channel will be set to Low when the Event is activated. The channel(s) can be selected from the channel list on the right-hand side. An automatic reset of the channel after 0 - 3600 seconds can optionally be selected.

Note

  • To use connected digital channels as Digital Out channels the Channel Mode must be set to Digital Out in the Data Channels menu (see Fig. 405).

    Changing the channel mode of a digital channel

    Fig. 405 Changing the channel mode of a digital channel

  • The number of alarms is counted and displayed in the Action bar. To quit the alarms, click on the bell symbol in the action bar and click on the green check mark (see Fig. 406).

    Alarm Counter

    Fig. 406 Alarm Counter

  • An Alarm Action can also be selected if Continuous Waveform Recording is enabled and does not have to be event based.

Marker Action

Trigger - Marker Action

Fig. 407 Trigger - Marker Action

This action adds a marker with a user defined marker text.

  • On active only: Marker is only set if the event is activated

  • On inactive only: Marker is only set if the event is deactivated

  • On active and inactive: Marker is set if the event is activated and if the event is deactivated

Note

A Marker Action can also be selected if Continuous Waveform Recording is enabled and does not have to be event based.

Snapshot Action

Trigger - Snapshot Action

Fig. 408 Trigger - Snapshot Action

The Snapshot action can be used to query the Actual Value, Average, MIN, MAX, RMS, ACRMS or Peak2Peak value of one or several channels that may be selected on the right-hand side of the menu (see ① in Fig. 396) and copy this value to a new channel. This channel is added to the Channel List and can be found in the Snapshot: Event x section (see Fig. 409). If a statistical value is selected, the calculation time interval can be defined in the Snapshot window input field (see Fig. 408). The time interval is applied prior to the activation of the event.

Snapshot channel in the Channel List

Fig. 409 Snapshot channel in the Channel List

Note

The same snapshot action can be applied to several channels by selecting them in the Channel list on the right-hand side (see Fig. 410). An own snapshot channel for each selected channel is created in the Channel List (see Fig. 411). Selecting several channels in the Snapshot Action menu will result in an own snapshot channel in the Channel List for each selected channel

Selecting several channels in the Snapshot Action menu

Fig. 410 Selecting several channels in the Snapshot Action menu

Snapshot channel in the Channel List for each selected channel

Fig. 411 Snapshot channel in the Channel List for each selected channel

Arming the Trigger

If Event Based Waveform Recording is selected, a flash will appear within the sign of the record button (see Fig. 412).

Action bar with enabled *Event Based Waveform* Recording

Fig. 412 Action bar with enabled Event Based Waveform Recording

After pressing the record button, the Event Based Waveform Recording is armed and the recording will be started and paused according to the defined trigger events. Measurement data will be written to ONE data file.

Note

If the trigger condition is active while arming the trigger, the trigger will not be detected as the trigger condition is not passed.

Application Examples

Event Based Waveform Recording triggered by an input channel

Example 1

Challenge: Start Recording when the value of a certain analog input channel exceeds 1 and Pause Recording again when the value exceeds 2.

  • Select Event based Waveform Recording as Recording Mode (see Fig. 413):

    Event based Waveform Recording selection

    Fig. 413 Event based Waveform Recording selection

  • Add an Event. Select Level High as Condition Type and set the Threshold to 1. Select the analog input channel to be triggered on in the Channel List on the right-hand side (see Fig. 414):

    Level High Condition Type; Threshold: 1

    Fig. 414 Level High Condition Type; Threshold: 1

  • Select Start recording as Action Type (see Fig. 415):

    Start Recording Action Type

    Fig. 415 Start Recording Action Type

  • Add another event. Select Level High as Condition Type and set the Threshold to 2. Select the analog input channel to be triggered on in the Channel List on the right-hand side (see Fig. 416):

    Level High Condition Type; Threshold: 2

    Fig. 416 Level High Condition Type; Threshold: 2

  • Select Pause recording as Action Type (see Fig. 417):

    Pause Recording Action Type

    Fig. 417 Pause Recording Action Type

Example 2

Challenge: Record data every time the value of an analog input channel is within 1 and 2. The difference to the example above in Example 1 is that in Example 1 data recording is not started when the value decreases below 2 and does not pause the recording when the value decreases below 1. In this Example 2, it is the case as well.

  • Select Event based Waveform Recording as Recording Mode (see Fig. 418):

    Event based Waveform Recording selection

    Fig. 418 Event based Waveform Recording selection

  • Select Window IN as Condition Type and set the Lower level to 1 and the Upper level to 2. Select the analog input channel to be triggered on in the Channel List on the right-hand side (see Fig. 419):

    Window In Condition Type; 1...2

    Fig. 419 Window In Condition Type; 1…2

  • Select Record Event as Action Type (see Fig. 420):

    Record Event Action Type

    Fig. 420 Record Event Action Type

Time Triggered Data Recording

Challenge: Record data every 60 minutes for 2 minutes.

  • Select Event based Waveform Recording as Recording Mode (see Fig. 421):

    Event based Waveform Recording selection

    Fig. 421 Event based Waveform Recording selection

  • Select the Time Condition and enter 1h as Time interval and enable Active for 2 minutes (see Fig. 422):

    Recording every 60 minutes for 2 minutes

    Fig. 422 Recording every 60 minutes for 2 minutes

  • Select Record Event as Recording Action Type (see Fig. 423):

    Record Event Action Type

    Fig. 423 Record Event Action Type

Data Query using the Snapshot Action

Challenge: When the space key is pressed, the RMS value 0.5s prior to the event of 4 analog input channels shall be queried using the snapshot action. When the space button is pressed, a marker shall be added to the time position and a Digital Out channel shall be set to High state.

  • Select Continuous Waveform Recording as Recording Mode (see Fig. 412):

    Continuous Waveform Recording selection

    Fig. 424 Continuous Waveform Recording selection

  • Select Keyboard Condition Type and True while hold as Condition State with the Space key as Shortcut (see Fig. 425):

    Space key Condition type

    Fig. 425 Space Key Condition type

  • Select Snapshot as Action Type and select RMS value as Action with a Snapshot window of 0.5s. The analog input channels used for the data query can be selected in the channel list on the right-hand side (see Fig. 427). Data will be queried in the moment the Event configured above is activated.

    Snapshot Action Type

    Fig. 426 Snapshot Action Type

  • To set the Digital Channel to High state, add another Action by pressing the +Add Action button, select Alarm Action Type and select Digital out – High on alarm as Action. The Digital out channel to be set can be selected in the channel list on the right-hand side (see Fig. 426). The channel mode of the desired Digital channel must be set to Digital out in the Channel List (see Fig. 405).

    Alarm Action Type

    Fig. 427 Alarm Action Type

  • To add a Marker in the data file at the instant of time the Event is activated and data is queried, add another Action by pressing the +Add Action button, select Marker Action Type and select On active only as Action. A marker is now added when the Event is activated.

    Marker Action Type

    Fig. 428 Marker Action Type

Advanced Storing Modes

The advanced storing modes are available in the Trigger Menu, in the individual channel configuration section (see ① in Fig. 429). The individual channel configuration includes the following options:

  • Store channels at different sample rates on triggered events

  • Choose between different options for the statistics data

  • Set different time windows for the statistics data for individual channels

In order to activate the individual channel configuration click on the checkbox button Customize settings per channel (see ② in Fig. 429).

Individual channel configuration in Trigger Menu

Fig. 429 Individual channel configuration in Trigger Menu

In this channel configuration some known settings from the Data Channel List can be found, like the channel filter or color bar. These settings are described in Data channels menu. To keep the overview the three relevant columns for the individual channel configuration will be explained here:

  • Waveform Mode

  • Statistics Mode

  • Statistics Window

Note

The sample rate is shown here, just like in the data channel list, but it cannot be changed in this configuration menu. In order to change the sample rate for individual channels, go to the Data Channel list and refer to Channel-wise Sample Rate Selector, where it is described in detail how to change sample rates channel-wise.

Waveform Mode

The Waveform Mode offers two different options seen in Fig. 430.

Options for Waveform Mode in Advanced Storing Modes

Fig. 430 Options for Waveform Mode in Advanced Storing Modes

Default refers to the settings, which were made in the trigger menu. For details about the settings in the trigger menu, refer to Triggered Events. Continuous means, that the channel will always be stored, from the moment the trigger will be armed, and the trigger settings will be ignored. In this case this button in the action bar image45 acts as the normal Recording start button.

Only after the event happens, the other channels with the default setting will also be stored with the defined sample rate. An exemplary representation on when and what channels are stored is shown in Fig. 431. Whenever the trigger is armed on the measurement screen in the action bar, the channels with the Waveform Mode Continuous are stored from that moment on. At the time the set events happen, also the channels with the Waveform Mode Default are stored at the defined sample rate.

Representation of Continuous and Default Storing Mode

Fig. 431 Representation of Continuous and Default Storing Mode

The selected sample rate at which the channel will be stored can be seen in the Sample Rate column. To change the sample rate, go to the Data Channel list.

Note

In case the Waveform Mode of a whole Power Group (all parameters within the Power Group) wants to be changed, the checkbox of the Power Group has to be specifically selected before changing the Waveform Mode (see Fig. 432). If only the row of the channel is clicked on, the Mode does not change for the individual Power channels. Of course, all the parameters of the Power Group can also set to an individual Waveform Mode.

Changing Waveform Mode for a whole Power Group

Fig. 432 Changing Waveform Mode for a whole Power Group

Statistics Mode

The statistics mode offers different possibilities seen in Fig. 433.

  • Off: No statistics data will be calculated or stored for this channel

  • Min/Max/Avg/RMS: these four values are calculated as statistical values for the channel

  • Skip: Only the first sample of the set statistics window is stored

Options for Statistics Mode in Advanced Storing Modes

Fig. 433 Options for Statistics Mode in Advanced Storing Modes

Statistics Window

The time window to calculate the statistics data can be set individually per channel, seen in Fig. 434.

Default refers to the settings for the statistics data in the trigger menu, see Fig. 435.

For the time window a value from the drop-down list can be chosen or a value from \frac{1}{\text{sample\ rate}} up to 10 s can be entered.

Options for Statistics Window in Advanced Storing Modes

Fig. 434 Options for Statistics Window in Advanced Storing Modes

Settings for Statistical Data in Trigger Menu

Fig. 435 Settings for Statistical Data in Trigger Menu

Note

If the Statistics Data is disabled in the trigger settings (see Fig. 435), the columns Statistics Mode and Statistics Window disappear and are not shown in the Individual Channel Configuration anymore.

Example

This section describes an example, to give a better understanding of the Advanced Storing Modes.

Fig. 436 and Fig. 437 both show the settings, which were made. This example shows how to continuously store the power parameters but only store the raw data in case of an event. For the raw data also different sample rates are set (refer to Channel-wise Sample Rate Selector) and different settings for the statistics data.

Example: Trigger Event Settings

Fig. 436 Example: Trigger Event Settings

Example: Individual Channel Configuration Settings

Fig. 437 Example: Individual Channel Configuration Settings

  1. To continuously store the power parameters the Waveform Mode is set to Continuous (consider the note in Waveform Mode).

    Whenever the trigger will be armed, all those parameters are recorded and stored.

  2. The other channels of the TRION-1820-POWER-4 card are set to the Waveform Mode Default. This means, that the trigger event settings are considered here. By looking at Fig. 436 it can be seen, that the recording will be started whenever the Trigger Channel rises above the defined threshold of 9 V. At this point the raw data channels are also recorded and stored with a sample rate of 200 kHz, or 10 kHz for channel I_net and U_net.

  3. Additionally, those channels have different settings for the Statistics Data.

    1. Channel I_1: The Min/Max/Avg/RMS value will be stored for a time window of 0.001 s.

    2. Channel I_2 and I_3: Statistics Data is turned off and will not be calculated nor stored.

    3. Channel I_net: The Min/Max/Avg/RMS value will be stored for a time window of 0.1 s.

    4. Channel U_1: The Min/Max/Avg/RMS value will be stored for the default time window, which is set in the trigger settings and is per default of 1 s.

    5. Channel U_2: only the first sample of the defined time window of 0.1 s is stored.

    6. Channel U_3: only the first sample of the default time window of 1 s, which is set in the trigger settings, is stored.

    7. Channel U_net: The Min/Max/Avg/RMS value will be stored for a time window of 0.1 s.

The individual channel configuration should be done carefully to make the right settings, since complex setups can be created like this.