Obtains a waveform from the digitizer and returns the specified measurement voltage data. Unlike the Measurement 1D DBL instance of the niScope Fetch Measurement VI, the Measurement 2D DBL instance can fetch data from multiple channels and records.


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 array measurement —

    array measurement is the array measurement to add as a processing step.

    Default Value: None

    Refer to the list of NI-SCOPE Array 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.

  • ci32.png meas waveform size —

    meas waveform size is the maximum number of samples returned in the measurement waveform array for each waveform measurement.

    Default Value: –1 (returns all available samples)

    Note Use the property Fetch Meas Num Samples to set the number of samples to fetch when performing a measurement.
  • iivrn.png instrument handle out —

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

  • i1dnclst.png wfm info —

    wfm info contains all the timing and scaling information about the waveform.

  • ii32.png actualSamples —

    actualSamples is the actual number of samples in the acquired waveform; this number may be less than numSamples if the number you request is not available.

  • idbl.png absoluteInitialX —

    absoluteInitialX is the timestamp in seconds of the first fetched sample. This timestamp is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.

  • idbl.png relativeInitialX —

    relativeInitialX is the time in seconds from the trigger to the first sample in the acquired waveform.

  • idbl.png xIncrement —

    xIncrement indicates the time in seconds between two samples in the acquired waveform.

  • idbl.png offset —

    offset is the offset factor of the given channel.

    Use for scaling binary data with the following formula:

    voltage = binary data × gain factor + offset

  • idbl.png gain —

    gain is the gain factor of the given channel.

    Use for scaling binary data with the following formula:

    voltage = binary data × gain factor + offset

  • idbl.png reserved1 —

    reserved1 is reserved. Do not use.

  • idbl.png reserved2 —

    reserved2 is reserved. Do not use.

  • i2ddbl.png wfm —

    wfm is an array of waveforms; that is, a two-dimensional array. This output can be wired directly to the LabVIEW waveform graph, but each waveform is plotted without timing information.

    The 2D array 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 fetch VI during a normal acquisition with the channel string "0,1" and the record number set to –1, the order of the output is:

    record 0, channel 0

    record 0, channel 1

    record 1, channel 0

    record 1, channel 1

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

  • ierrcodeclst.png error out —

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