Obtains a waveform from the digitizer and returns the specified array measurement for multiple channels and records as a cluster.


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.

  • i1dcclst.png meas waveform —

    meas waveform returns an array of clusters for wiring to a graph, including the timing information.

    If you specify a channel list, NI-SCOPE returns the waveforms in the list order. NI-SCOPE returns these records sequentially, so all record 0 waveforms are first. For example, with a two-channel list, you would have the following index values:

    index 0 = record 0, channel 0

    index 1 = record 0, channel 1

    index 2 = record 1, channel 0

    index 3 = record 1, channel 1

  • idbl.png relativeInitialX —

    relativeInitialX is the initial x value relative to the trigger, such that the trigger always occurs at time equals zero.

  • idbl.png xIncrement —

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

  • i1ddbl.png measWfm —

    measWfm returns a one-dimensional array of data for one waveform.

  • ierrcodeclst.png error out —

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