libtcspc.MarkerEvent¶

class libtcspc.MarkerEvent(numeric_traits=None)[source]¶

Bases: EventType

Event representing a timing marker or external trigger.

Used for frame, line, and pixel markers in scanning microscopy, and for other external trigger signals that the TCSPC hardware records alongside detections.

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 fields abstime and channel. When the hardware reports multiple simultaneous markers, one event is emitted per channel sharing the same abstime; the ordering among simultaneous markers is unspecified. The marker channel numbering may or may not share a namespace with detection channels, depending on the device.

A value is constructed by giving all fields, e.g. MarkerEvent(nt).value(abstime=42, channel=1); 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.