niScope Fetch (poly)

NI-SCOPE LabVIEW

previous page next page

niScope Fetch (poly)

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

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.

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.
instrument handle identifies a particular instrument session.
channel is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info contains all the timing and scaling information about the waveform.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
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.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
wfm is an array of waveform data containing one waveform without timing information.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

1D I8

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

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.
instrument handle identifies a particular instrument session.
channel is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info contains all the timing and scaling information about the waveform.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
wfm returns a one-dimensional array of data.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

1D I16

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

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.
instrument handle identifies a particular instrument session.
channel is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info contains all the timing and scaling information about the waveform.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
wfm returns a one-dimensional array of data.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

1D I32

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

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.
instrument handle identifies a particular instrument session.
channel is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info contains all the timing and scaling information about the waveform.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
wfm returns a one-dimensional array of data.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

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.

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

Defined Values

absolute

relative
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.
instrument handle identifies a particular instrument session.
channel is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info contains all the timing and scaling information about the waveform.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
wfm returns data for wiring to a graph, including the timing information.
t0 is the time corresponding to the first data value in the waveform.
dt is the time interval, or duration, between data points in the waveform.
Y contains the data values of a waveform.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

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.

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.
instrument handle identifies a particular instrument session.
channelList is the channel from which to acquire data. For more information, refer to Channel String Syntax.

Default Value: 0
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info is an array of clusters. Each waveform in the output array has some corresponding information.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
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 function 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

initial X contains the time (in seconds) of the first point in the waveform with respect to the trigger.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
waveform contains the voltage data (the y-axis data in the graph).
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

2D I8

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

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.
instrument handle identifies a particular instrument session.
channelList is the channel from which to acquire data. For more information, refer to Channel String Syntax.

Default Value: 0
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info is an array of clusters. Each waveform in the output array has some corresponding information.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
wfm returns a two-dimensional array of binary data; if you specify a channelList, 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
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

2D I16

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

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.
instrument handle identifies a particular instrument session.
channelList is the channel from which to acquire data. For more information, refer to Channel String Syntax.

Default Value: 0
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info is an array of clusters. Each waveform in the output array has some corresponding information.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
wfm returns a two-dimensional array of binary data; if you specify a channelList, 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
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

2D I32

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

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.
instrument handle identifies a particular instrument session.
channelList is the channel from which to acquire data. For more information, refer to Channel String Syntax.

Default Value: 0
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info is an array of clusters. Each waveform in the output array has some corresponding information.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
wfm returns a two-dimensional array of binary data; if you specify a channelList, 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
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

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.

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.
instrument handle identifies a particular instrument session.
channelList is the channel from which to acquire data. For more information, refer to Channel String Syntax.

Default Value: 0
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info is an array of clusters. Each waveform in the output array has some corresponding information.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
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 function 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 channelList parameter.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

1D 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.

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

Defined Values

absolute

relative
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.
instrument handle identifies a particular instrument session.
channel is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info contains all the timing and scaling information about the waveform.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
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

t0 is the time corresponding to the first data value in the waveform.
dt is the time interval, or duration, between data points in the waveform.
Y contains the data values of a waveform.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

1D DBL

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

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.
instrument handle identifies a particular instrument session.
channel is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info contains all the timing and scaling information about the waveform.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
wfm is an array of waveform data containing one waveform without timing information.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

1D Complex DBL

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

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.
instrument handle identifies a particular instrument session.
channelList is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info contains all the timing and scaling information about the waveform.
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.
absoluteInitialX is the absolute x value of the first sample that is comparable between waveforms. For devices that do not support this feature, the value is always 0.
relativeInitialX is the initial x value relative to the trigger, such that the trigger always occurs at time equals zero.
xIncrement is the x increment between two samples in the waveform. This value is 1/(sampling rate) for time-domain acquisitions.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
wfm is an array of waveform data containing one waveform without timing information.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

Cluster Complex DBL

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

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.
instrument handle identifies a particular instrument session.
channelList is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info contains all the timing and scaling information about the waveform.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
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.
t0 is the initial time value relative to the trigger, such that the trigger always occurs at time equals zero.
dt is the time increment between two samples in the waveform. This value is 1/(sampling rate) for time-domain acquisitions.
Y is an array of waveform data containing one waveform.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

2D Complex DBL

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

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.
instrument handle identifies a particular instrument session.
channelList is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info is an array of clusters. Each waveform in the output array has corresponding information.
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.
absoluteInitialX is the absolute x value of the first sample that is comparable between waveforms. For devices that do not support this feature, the value is always 0.
relativeInitialX the initial x value relative to the trigger, such that the trigger always occurs at time equals zero. .
xIncrement the x increment between two samples in the waveform. This is 1/(sampling rate) for time domain acquisitions.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
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 channelList parameter.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.

1D Cluster Complex DBL

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.

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.
instrument handle identifies a particular instrument session.
channelList is the channel from which to acquire data. For more information, refer to Channel String Syntax.
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.
error in describes error conditions that occur before this VI runs. The default input of this cluster is no error. If an error already occurred, this VI returns the value of error in in error out. The VI runs normally only if no incoming error exists. Otherwise, the VI passes the error in value to error out. The error in cluster contains the following parameters:
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a negative error code. If status is FALSE, code is 0 or a warning code.
source identifies where an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
instrument handle out has the same value as the instrument handle.
wfm info is an array of clusters. Each waveform in the output array has corresponding information.
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.
absoluteInitialX is the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions; devices that do not support this parameter use 0 for this output.
relativeInitialX is the time in seconds from the trigger to the first sample in the fetched waveform.
xIncrement indicates the time in seconds between two samples in the acquired waveform.
gain is the gain factor of the given channel.

Use for scaling binary data with the following formula:

voltage = binary data × gain factor + 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
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 function 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 channelList parameter.

t0 is the initial time value relative to the trigger, such that the trigger always occurs at time equals zero.
dt is the time increment between two samples in the waveform. This value is 1/(sampling rate) for time-domain acquisitions.
Y is an array of waveform data containing one waveform.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
source identifies where and why an error occurred. The source string includes the name of the VI that produced the error, what inputs are in error, and how to eliminate the error.
previous page start next page