niScope Fetch (poly)

NI High-Speed Digitizers Help (NI-SCOPE)

Edition Date: January 2017

Part Number: 370592AB-01

View Product Info

DOWNLOAD (Windows Only)


NI-SCOPE (English | Japanese)

Retrieves data that the digitizer has acquired from a previously initiated acquisition.

Related topics

Use the pull-down menu to select an instance of this VI.

Cluster

Retrieves the waveform the digitizer has acquired for the specified channel from a previously initiated acquisition. Returns scaled voltage waveforms in a cluster that includes timing information.

niScope Fetch Cluster

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/inclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/icclst.gif

waveform is a cluster containing the initial x value, xIincrement, and a waveform array. This output can be wired directly to the LabVIEW waveform graph, so the waveform is plotted with timing information. The initial x value in the cluster is relative to the trigger. The relative initial x value is the time from the trigger to the first point so the trigger always occurs at time equals zero.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/i1ddbl.gif

wfm is an array of waveform data containing one waveform without any timing information.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

1D I8

Retrieves data from a single channel and record. Returns a one-dimensional array of binary 8-bit values.

niScope Fetch Binary 8

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/inclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i1di8.gif

wfm returns a one-dimensional array of data.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

1D I16

Retrieves data from a single channel and record. Returns a one-dimensional array of binary 16-bit values.

niScope Fetch Binary 16

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/inclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i1di16.gif

wfm returns a one-dimensional array of data.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

1D I32

Retrieves data from a single channel and record. Returns a one-dimensional array of binary 32-bit values.

niScope Fetch Binary 32

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/inclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i1di32.gif

wfm returns a one-dimensional array of data.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

Fetch

Retrieves data from a single channel and record. Returns a one-dimensional array of scaled voltages.

niScope Fetch

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/inclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i1ddbl.gif

wfm is an array of waveform data containing one waveform without any timing information.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

WDT (Waveform Data Type)

Retrieves a waveform the digitizer has acquired for the specified channel. Returns scaled voltage data in a waveform data type that includes timing information.

niScope Fetch WDT

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/ci32.gif

timestamp Type specifies the time basis for the timestamp on the WDT data.

Defined Values

absolute

relative

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/inclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/iwfm.gif

wfm returns data for wiring to a graph, including the timing information.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

Complex WDT (Waveform Data Type)

Retrieves complex waveforms the digitizer has acquired for the specified channel. Returns a two-dimensional array of LabVIEW complex waveform data types that includes timing information.

niScope Fetch Complex WDT

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/ci32.gif

timestamp Type specifies the time basis for the timestamp on the WDT data.

Defined Values

absolute

relative

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/inclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/iwfm.gif

wfm returns data for wiring to a graph, including the timing information.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

1D CDB

Retrieves data from single channels and records. Returns a one-dimensional array of complex, scaled waveforms.

niScope Fetch Complex Double

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/inclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i1dcdb.gif

wfm is an array of waveform data containing one waveform without timing information.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

Cluster CDB

Retrieves data from single channels and records. Returns a complex, scaled waveform in a cluster that contains timing information.

niScope Fetch Cluster Complex Double

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/inclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/icclst.gif

waveform is a cluster containing the initial time value, time increment, and a waveform array. The initial time value in the cluster is relative to the trigger. The relative initial time value is the time from the trigger to the first point so the trigger always occurs at time equals zero.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

dt is the time interval between two samples in the waveform. This value is 1/(sampling rate) for time-domain acquisitions.

/images/reference/en-XX/help/370592AB-01/i1dcdb.gif

Y is an array of waveform data containing one waveform.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

2D I8

Retrieves data from multiple channels and records. Returns a two-dimensional array of binary 8-bit waveforms.

niScope Multi Fetch Binary 8

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/i1dnclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i2di8.gif

wfm returns a two-dimensional array of binary data; 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

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

2D I16

Retrieves data from multiple channels and records. Returns a two-dimensional array of binary 16-bit waveforms.

niScope Multi Fetch Binary 16

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/i1dnclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i2di16.gif

wfm returns a two-dimensional array of binary data; 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

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

2D I32

Retrieves data from multiple channels and records. Returns a two-dimensional array of binary 32-bit waveforms.

niScope Multi Fetch Binary 32

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/i1dnclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i2di32.gif

wfm is an array of clusters. Each waveform in the output array has some corresponding information.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

2D DBL

Retrieves data from multiple records or multiple channels. Returns a two-dimensional array of scaled voltage waveforms. This VI makes it easy for you to save data to a disk or perform math operations.

niScope Multi Fetch

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/i1dnclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i2ddbl.gif

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.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

1D WDT (Waveform Data Type)

Retrieves waveforms the digitizer has acquired from multiple records or multiple channels. Returns a two-dimensional array of LabVIEW waveform data types that includes timing information.

niScope Multi Fetch WDT

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/ci32.gif

timestamp Type specifies the time basis for the timestamp on the WDT data.

Defined Values

absolute

relative

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/i1dnclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i1dwfm.gif

wfm returns a one-dimensional array of LabVIEW waveform data types that contain 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

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

1D Complex WDT (Waveform Data Type)

Retrieves complex waveforms the digitizer has acquired from multiple records or multiple channels. Returns a two-dimensional array of LabVIEW complex waveform data types that includes timing information.

niScope Multi Fetch Complex WDT

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/ci32.gif

timestamp Type specifies the time basis for the timestamp on the WDT data.

Defined Values

absolute

relative

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/i1dnclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i1dwfm.gif

wfm returns a one-dimensional array of LabVIEW waveform data types that contain 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

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

2D CDB

Retrieves data from multiple channels and records. Returns a two-dimensional array of complex, scaled waveforms.

niScope Multi Fetch Complex Double

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/i1dnclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i2dcdb.gif

wfm is an array of waveforms; that is, a two-dimensional array.

The 2D array includes waveforms from multiple channels, records, and acquisition types. For example, if the acquisition type is normal, one waveform per channel per record is acquired. 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.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

1D Cluster

Retrieves the waveform the digitizer has acquired for multiple channels and records. Returns scaled voltage waveforms in a cluster that includes timing information.

niScope Multi Fetch Cluster

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/i1dnclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i1dcclst.gif

waveform is an array of clusters, each containing the initial x value, x increment, and a waveform array.

This output can be wired directly to the LabVIEW waveform graph, so each waveform in the array is plotted with timing information. The initial x value in the cluster is the value relative to the trigger. The relative initial x value is the time from the trigger to the first point so the trigger always occurs at time equals zero.

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 fetch VI during a normal acquisition with the channel string "0,1" the order of the output is:

record 0, channel 0

record 0, channel 1

record 1, channel 0

record 1, channel 1

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/i1ddbl.gif

wfm contains the voltage data (the y-axis data in the graph).

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

Cluster CDB

Retrieves the waveform the digitizer has acquired for multiple channels and records. Returns a one-dimensional array of complex, scaled waveforms in clusters that include timing information.

niScope Multi Fetch Cluster Complex Double

/images/reference/en-XX/help/370592AB-01/cio.gif

instrument handle identifies a particular instrument session.

/images/reference/en-XX/help/370592AB-01/cstr.gif

channels specifies the channel from which to acquire data.

For more information, refer to Channel String Syntax.

/images/reference/en-XX/help/370592AB-01/ci32.gif

numSamples is the maximum number of samples to fetch for each waveform; if the acquisition finishes with fewer points than requested, some devices return partial data if the acquisition finished, was aborted, or a timeout of 0 was used. Use –1 for this parameter if you want to fetch all available samples. The VI reads the actual record length and attempts to acquire all available samples. If it fails to complete within the timeout period, the VI returns an error.

/images/reference/en-XX/help/370592AB-01/cdbl.gif

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.

/images/reference/en-XX/help/370592AB-01/cerrcodeclst.gif

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

/images/reference/en-XX/help/370592AB-01/iio.gif

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

/images/reference/en-XX/help/370592AB-01/i1dnclst.gif

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

/images/reference/en-XX/help/370592AB-01/ii32.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

offset is the offset factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + offset

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved1 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/idbl.gif

reserved2 is reserved. Do not use.

/images/reference/en-XX/help/370592AB-01/i1dcclst.gif

waveform is an array of clusters, each containing the initial time value, time increment, and a waveform array. The initial time value in the cluster is the value relative to the trigger. The relative initial time value is the time from the trigger to the first point so the trigger always occurs at time equals zero.

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 fetch VI during a normal acquisition with the channel string "0,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.

/images/reference/en-XX/help/370592AB-01/idbl.gif

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

/images/reference/en-XX/help/370592AB-01/idbl.gif

dt is the time interval between two samples in the waveform. This value is 1/(sampling rate) for time-domain acquisitions.

/images/reference/en-XX/help/370592AB-01/i1dcdb.gif

Y is an array of waveform data containing one waveform.

/images/reference/en-XX/help/370592AB-01/ierrcodeclst.gif

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

WAS THIS ARTICLE HELPFUL?

Not Helpful