libtcspc.TimeReachedEvent¶

class libtcspc.TimeReachedEvent(data_types=None)[source]¶

Bases: EventType

Keep-alive event indicating that the data source has reached a given time.

Serves two purposes: (a) propagating time progression when there are no detections to send (including marking the end of a measurement), and (b) preventing long gaps in abstime that would otherwise stall time-sensitive processors.

Parameters:: data_types (DataTypes or None) – Set of integer types parameterising the C++ event. None (the default) uses DataTypes defaults.

Notes

The corresponding C++ event has the field abstime. The emission frequency of these events can be tuned on the C++ side with tcspc::regulate_time_reached().