Appendix |
TTTR Record Format |
[Related Topics] |
This page describes the format of the TTTR data saved in the
Due to performance reasons the TTTR data are saved exactly as recieved from TCSPC device, hence the format of the TTTR records depends on the kind of TCSPC device and the type of measurement. The record format used in a particular file is denoted in the mandatory tag TTResultFormat_TTTRRecType.
Even though the record formats differ, the formal algorithms for the calculations on them don't: To get the global arrival time of a photon or a marker in seconds, count the overflows until the current position and multiply with the overflow period, then add the timetag (for T2) or nsync (for T3) and multiply with the MeasDesc_GlobalResolution.
The arrival time since the last sync event in T3 measurements is denoted in dtime. To get the time in seconds multiply dtime with MeasDesc_Resolution.
To reconstruct the image one needs marker defined as a line start, line stop and frame trigger. The corresponding header entries are ImgHdr_LineStart, ImgHdr_LineStop and ImgHdr_Frame. The line start and line stop markers mark the real start and stop of image line, a frame marker define a change of the frame.
Notice 1: The markers are bit coded in the TTTR records (see below), multiple markers can appear at once;
Especially the frame marker often overlay with a line start or line stop marker.
Notice 2: The marker positions in MicroTime200 images are different than before in the SymPhoTime 32. When
a MicroTime200 image is converted for the new software the markers are relocated to match the real line start, line stop
position.
Currently the following formats are defined:
RecType: | $00010203 | Overflow period: | 210698240 |
The bit allocation in the record is, starting from the MSB:
channel: 4
The channel code 15 (all bits ones) marks a special record.
timetag: 28
Special records can be overflows or external markers. To differentiate this, the lower 4 bits of timetag
must be checked.
RecType: | $00010303 | Overflow period: | 65536 |
The bit allocation in the record is, starting from the MSB:
channel: 4
The
dtime: 12
nsync: 16
channel
code 15 (all bits ones) marks a special record.
Special records can be overflows or external markers. To differentiate this, dtime
must be checked.
RecType: | $00010204 | Overflow period: | 33552000 | |
RecTypes: | $01010204, $01010205, $01010206 | Overflow period: | 33554432 |
The bit allocation in the record is, starting from the MSB:
special: 1
If the
channel: 6
timetag: 25
special
bit is clear, it's a regular event record.
If the special
bit is set, the following interpretation of the channel
code is given:
timetag
value.
RecType: | $00010304, $01010304, $00010305, $00010306 | Overflow period: | 1024 |
The bit allocation in the record is, starting from the MSB:
special: 1
If the
channel: 6
dtime: 15
nsync: 10
special
bit is clear, it's a regular event record.
If the special
bit is set, the following interpretation of the channel code is given:
nsync
value.
Related Topics: |