Documentation Home Page RT-LAB Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

OpTrigger

Library

rtlab/Data logging

Block

The OpTrigger block allows a user to trig an acquisition group on a specific signal.

OpTrigger block

Mask


OpTrigger mask.

Description

The OpTrigger block is used to control the acquisition system's start condition during the simulation. Data will be acquired only when a specific signal is triggered. The option of starting data acquisition only once a specified threshold is reached allows users to obtain information about a specified time-slice of the simulation.

Once started, the data acquisition/logging continues until it reaches the size defined in the number of samples per signal field on the OpWriteFile block mask. After this, acquisition may be re-triggered if the condition is still true.

When being used along with an OpWriteFile (same Acquisition Group number set), if the block is triggered after the file is full (file size limit is reached), the .mat file is not overritten, data collected during the initial trigger(s) is kept.

Parameters

Conditioncondition to be satisfied so that the acquisition system is triggered. It is one of the following:

  • Rising or falling edge,
  • Rising edge (the threshold is crossed on a positive slope, that is from below),
  • Falling edge (the threshold is crossed on a negative slope, that is from above),
  • Trigger signal >= trigger level,
  • Trigger signal <= trigger level.
Offsetif this parameter is a positive value, it is used to set the number of steps (cycles) to wait before starting the acquisition system, once the trigger condition is met. The default value is 0, which means start as soon as the trigger condition is met. The trigger offset can also be a negative value n. In this case, the n samples which correspond to the simulation results of the n steps before the trigger condition happened will be acquired (up to the number of samples per signals). The range value for the offset is [-FrameSize ; +FrameSize]. The frame size is defined in the number of samples per signal field on the OpWriteFile block mask.
Acquisition groupspecifies the acquisition group to be controlled by this block.

Inputs

Trigger signalthe signal that is compared with trigger level.
Trigger levelusually a constant value. Specifies the value that must be reached by the trigger signal to trigger acquisition.

Outputs

Trigger outputstatus of the acquisition. A zero (0) indicates that no acquisition is in progress; a one (1) indicates that data is being acquired.

Characteristics and Limitations

Direct Feedthrough

No

Discrete sample time

No

XHP support

Yes

Work offline

No

OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323