qutools quTAU, Руководство пользователя

Страница: 32 / 44

11 HISTOGRAMS
side, the retrieved data are shown in the plot on the left.
11.1.2 DLL Usage
Table 9: Examples: Start-Stop Histograms
LabView Example
/userlib/labviewXX/examples/start-stop.vi
C Example
-
Example
start-stop.vi
describes how to retrieve start-stop histograms using the DLL
(see fig. 22 ). The generation of start-stop histograms has to be enabled explicitly using
TDC enableStartStop
. Further, the histogram width and resolution has to be specified
using
TDC setHistogramParams
. This is done using the two parameters ”bincount” (the
number of bars is the histogram) and ”binwidth” (number of device time bins summarized
in one histogram bin).
Once enabled, all available histograms are continuously generated. The parameters of
TDC getHistogram
determine the channel combination to be retrieved. Additionally, an
array with at least bincount entries has to be provided in the function call.
In case the histograms for multiple channel combinations are necessary, they can be
retrieved one after the other. In order to get the histograms for the same integration time
each, use
TDC freezeBuffers
.
Functions relevant to Start Stop Histograms:
tdcstartstop.h:
int TDC enableStartStop (Bln32 enable)
int TDC setHistogramParams (Int32 binWidth, Int32 binCount)
int TDC getHistogramParams (Int32 ∗ binWidth, Int32 ∗ binCount)
int TDC clearAllHistograms ()
int TDC getHistogram (Int32 chanA, Int32 chanB, Bln32 reset, Int32
∗
data,
Int32
∗
count, Int32
∗
tooSmall, Int32
∗
tooLarge, Int32
∗
eventsA, Int32
∗
eventsB, Int64
∗
expTime)
int TDC freezeBuffers (Bln32 freeze)
www.qutools.com quTAU/quPSI Manual V4.0 Page 32