User manual

Discussion
Because the acquisition control loop is done inside this function, it is suitable only for single instrument,
single channel operation.
This function uses the AcqrsD1_readData routine. However, only 'readPar->nbrSegments = 1' and 'readPar-
>readMode = 0' (ReadModeStdW) are supported. 'readPar->dataType = 3' (real) and 'readPar->dataType =
2' (long) are NOT supported.
The sumArray contains either the average values (calculateMean = TRUE), or the sample-by-sample sums
(calculateMean = FALSE). Note that, in the latter case, the sumArray can be interpreted as an unsigned
integer. Alternatively, negative values have to be increased by 2**32.
The number of acquisitions, nbrAcq, can be at most 16777216 for 'readPar->dataType = 0' (char) or 65536
for 'readPar->dataType = 1' (short). This is to avoid an overflow where the summed values will wrap around
0.
The value in Volts of a data point data in the returned waveformArray or normalized sumArray can be
computed with the formula:
V = dataDesc.vGain * data – dataDesc.vOffset
The function will return ACQIRIS_ERROR_ACQ_TIMEOUT if there is no trigger within the specified
timeout interval after the start of each acquisition.
LabWindowsCVI/Visual C++ Representation
ViStatus AcqrsD1_averagedData(ViSession instrumentID,
ViInt32 channel, AqReadParameters* readPar, ViInt32
nbrAcq, ViInt8 calculateMean,
ViReal64 timeout,
void* dataArray, ViInt32 sumArray[], AqDataDescriptor*
dataDesc,
void* segDescArray);
LabVIEW Representation
Acqiris Dx.lvlib: (or Aq Dx) Averaged Data.vi
This Vi is polymorphic, the sample data is returned in an array of type I8 or I16.
Programmer’s Reference Manual Page 48 of 210