PeriodicTrigger('Interval*','StartTime*','UseSystemTime*')

Arguments

'Interval*'

Interval in minutes, in which the value TRUE is returned

'StartTime*'

Specification in minutes; produces the start time ('StartTime' modulo 'Interval') after using the modulo function

'UseSystemTime*'

Determines whether the system time or internal high-resolution timer is used.

'UseSystemTime = 0

No system time but internal timer is used.

'UseSystemTime' > 0

System time is used.

Parameters ending with * are only evaluated once at the start of the acquisition.

Description

This function returns the value TRUE every ‘Interval’ minutes, starting at ‘StartTime’ modulo 'Interval' minutes. The ‘UseSystemTime’ flag determines whether the system time or the internal high-resolution timer is to be used.

Example

Displaying a trigger every 10 seconds

Solution

Display of the following functions:

    • PeriodicTrigger(10/60, 10/60, 1)

    • PeriodicTrigger(10/60, 11/60, 1)

    • PeriodicTrigger(10/60, 15/60, 1)

with 10/60 min (corresponds to 10 s) for 'Interval,' again 10/60 min or 11/60 min (11 s) and 15/60 min (15 s) for 'StartTime' and 1 (system time) for 'UseSystemTime.'

As the following illustration shows, the triggers every 10 s differ in their start time. According to the calculation method, the trigger starts the interval of the red chart at time 0 s, the green chart at 1 s and the blue chart at 5 s after the acquisition.