qutools quTAU, Manual

Page: 36 / 44

11 HISTOGRAMS
Again, the lifetime feature has to be enabled explicitly after the histogram parameters
have been set. In this case, the number of bins (”bincount”) is for the positive bins only.
Additionally, a storage container for the measurement (and a second one for the fit if
needed) has to be generated. This is done with the function call
TDC createLftFunction
.
For the procedure to get the histograms from the device and to fit one of the provided
model functions confer Figure
24 .
Note, that the size of the containers/data sets has to match the number of bins in the
histogram. Therefore, if you change the histogram size you need to release and recreate
the data sets with
TDC releaseLftFunction
and
TDC createLftFunction
.
Usage examples are also available in the
src
folder as
example[5].c
.
Functions relevant to Lifetime Measurements:
tdcbase.h:
Bln32 TDC checkFeatureLifeTime ()
tdclifetime.h:
int TDC enableLft (Bln32 enable)
int TDC setLftParams (Int32 binWidth, Int32 binCount)
int TDC getLftParams (Int32 ∗ binWidth, Int32 ∗ binCount)
int TDC setLftStartInput (Int32 startChan)
int TDC getLftStartInput (Int32
∗
startChan)
int TDC resetLftHistograms (void)
TDC LftFunction ∗ TDC createLftFunction (void)
void TDC releaseLftFunction (TDC LftFunction ∗ fct)
void TDC analyseLftFunction (const TDC LftFunction
∗
fct, Int32
∗
capacity,
Int32
∗
size, Int32
∗
binWidth, double
∗
values, Int32 bufSize)
int TDC getLftHistogram (Int32 channel, Bln32 reset, TDC LftFunction
∗
fct,
Int32 ∗ tooBig, Int32 ∗ startEvts, Int32 ∗ stopEvts, Int64 ∗ expTime)
int TDC calcLftModelFct (LFT FctType fctType, const double ∗ params,
TDC LftFunction
∗
fct)
int TDC generateLftDemo (LFT FctType fctType, const double
∗
params,
double noiseLv)
int TDC fitLftHistogram (const TDC LftFunction ∗ fct, LFT FctType fit-
Type, const double ∗ startParams, double ∗ fitParams, Int32 ∗ iterations)
www.qutools.com quTAU/quPSI Manual V4.0 Page 36