Series

class picodaq.stimulus.Series(train: Train | Pulse, traincount: int | None = None, trainperiod: Time = 0*s, duration: Time | None = None, pertrain: Deltas = <picodaq.stimulus.Deltas object>)

Representation of a series of trains

Parameters:

  • train – The constituent train of the series.

  • traincount – The number of trains in the series.

  • duration – The total duration of the series.

  • trainperiod – The period between consecutive trains.

  • pertrain – Changes to apply to parameters between trains.

Either the number of trains much be specified (with traincount), or the total duration of the series (with duration), but not both.

The trainperiod is measured start-to-start and is required except in episodic mode. If less than the duration of the train, the trains follow each other immediately.

Deltas specified with pertrain are applied between trains. That is: The first train and the following period are as stated; the second train and following period are modified by adding the deltas once; the third train and following period are modified by twice the deltas; etc.

Instead of a train, it is allowed to make a series comprise repeated individual pulses. This is strictly equivalent to putting in a train comprising just that one pulse.

duration(tight: bool = False) → Time

The duration of the series

Parameters:

tight – If true, the duration is measured to the end of the final pulse. Otherwise, it includes the (fictive) interval after the final pulse.