User manual

2.3.26 AcqrsD1_averagedData
Purpose
This function is intended for single instrument, single channel operation.
Perform a series of acquisitions and get the resulting averaged waveform.
Parameters
Input
Name Type Description
instrumentID ViSession Instrument identifier
channel ViInt32 1...Nchan
readPar AqReadParameters Requested parameters for the acquired waveform
nbrAcq ViInt32 Number of acquisitions to be performed.
calculateMean ViBoolean TRUE to divide the sumArray by nbrAcq to get the
mean values.
FALSE to leave the sample-by-sample sums in the
sumArray.
timeout ViReal64 Acquisition timeout in seconds. The function will
return an error if, for each acquisition, no trigger
arrives within the specified timeout after the start of the
acquisition.
The minimum value is 1 ms.
Output
Name Type Description
dataArray ViAddr User-allocated waveform destination array of type char
or byte. Its size in dataType units MUST be at least
'nbrSamples' + 32, for reasons of data alignment.
sumArray ViInt32 [ ] User-allocated waveform accumulation array. Its size
MUST be at least 'nbrSamples'. It is a 32-bit integer
(long) array, with the sample-by-sample sum of the
data values in ADC count unit (LSB). See discussion
below.
dataDesc AqDataDescriptor Waveform descriptor structure. The returned values
will be those of the last acquisition
segDescArray ViAddr Segment descriptor structure. The returned values will
be those of the last acquisition.
Return Value
Name Type Description
status ViStatus Refer to Table 2-1 for error codes.
Programmer’s Reference Manual Page 47 of 210