libtcspc.TimeReachedEvent¶

class libtcspc.TimeReachedEvent(numeric_traits=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:: numeric_traits (NumericTraits or None) – Set of integer types parameterising the C++ event. None (the default) uses NumericTraits 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().

A value is constructed by giving all fields, e.g. TimeReachedEvent(nt).value(abstime=42); read them back as attributes (inst.abstime).

Constructing and inspecting individual event values from Python is intended for debugging and learning only and is extremely slow; production graphs process events in compiled C++ and exchange bulk data via buckets.