Obtains a waveform measurement and returns the measurement value for multiple channel and multiple record acquisitions.

Specify a particular measurement type, such as rise time, frequency, or voltage peak-to-peak. The waveform on which the digitizer calculates the waveform measurement is from an acquisition that you previously initiated. The statistics for the specified measurement are also returned, where the statistics are updated once every acquisition when the specified measurement is fetched by any of the Fetch/Read waveform measurement VIs.


icon

Inputs/Outputs

  • cdbl.png timeout —

    timeout is the time (in seconds) to wait for the data to be acquired. Use 0 for this parameter to tell NI-SCOPE to fetch whatever is currently available. Using -1 for this parameter implies infinite timeout.

  • civrn.png instrument handle —

    instrument handle identifies a particular instrument session.

  • cstr.png channels —

    channels specifies the channel(s) from which to acquire data. For more information, refer to Channel String Syntax.

  • ci32.png scalar measurement —

    scalar measurement is the measurement to perform on the waveform read from the digitizer.

    Refer to the list of NI-SCOPE Scalar Measurements for more information.

  • cerrcodeclst.png error in —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • iivrn.png instrument handle out —

    instrument handle out has the same value as the instrument handle.

  • i1dnclst.png stats —

    stats is an array of clusters with scalar measurement results and statistics.

    The array of clusters includes waveforms from multiple channels, records, and acquisition types. For example, if the acquisition type is normal there is one waveform per channel per record. If you call the multi fetch measurement VI during a normal acquisition with the channel list "0,1", the order of the results output is:

    statistics for record 0, channel 0,

    statistics for record 0, channel 1,

    statistics for record 1, channel 0,

    statistics for record 1, channel 1

    The order of the channels is the order specified by the channels parameter.

  • idbl.png scalar result —

    scalar result contains the measurement.

  • idbl.png mean —

    mean returns the mean scalar value, which is obtained by averaging each niScope Multi Fetch Measurement Stats call.

  • idbl.png stdev —

    stdev returns the standard deviation.

  • idbl.png min —

    min returns the smallest scalar value acquired.

  • idbl.png max —

    max returns the largest scalar value acquired.

  • ii32.png num in stats —

    num in stats returns the number of measurements used to calculate the statistics.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.