A WCT “frame” represents a readout, either at the ADC tier or the signal (output of signal processing) tier. It is represented as a trio of arrays:
- frame
- a 2D array of data in channel (rows) vs tick (columns)
- channels
- a 1D array of the channel ident number of the rows
- tickinfo
- a trio of time values: $\{tstart, ttick, nbin0\}$
The frame array columns sample time according to the tick info.
The tickinfo
array has three time values,
- $tstart$
- The time of the start of the frame (but not necessarily the time of the frame array column 0). This measures absolute time from some assumed time origin. For most simulations, the time origin resets for each event.
- $ttick$
- The sampling period as relative floating point value. Often, this is the ADC sampling period but it may differ. For example, a frame may have been “rebinned” to from the ADC sampling period to a larger $ttick$.
- $npad$
- The number of $ttick$ counts from $tstart$ to the time of the lower edge of the first column in the frame array. This is an integer value (though stored as a double precision floating point).
When $npad≠ 0$ then the lower edge of column 0 of the frame array is at time \(tcol0 ≡ tstart + nbin0 * ttick\). When a frame array is required to span from $tstart$, the original frame array may be padded, typically with zeros.