Configure Number of Samples

Configures the number of samples in a finite acquisition or configures the device to continuously acquire samples.

Inputs/Outputs

datatype_icon

session in

Instrument session obtained from Initialize With Options.

datatype_icon

error in

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Default value: No error

datatype_icon

number of samples is finite

Boolean value that specifies whether to configure the device to acquire a finite number of samples or to acquire samples continuously.

True The NI-RFSA device acquires a finite number of samples.
False The NI-RFSA device continuously acquires samples until you call Abort to abort the acquisition.

Default value: True

datatype_icon

samples per record

Number of samples per record if the number of samples is finite input is set to True.

datatype_icon

session out

Reference to your instrument session passed to the next node.

datatype_icon

error out

Error information.

The node produces this output according to standard error behavior.

Standard Error Behavior

Hardware Support

This node supports the following hardware:

  • PXIe-5644/5645/5646
  • PXIe-5663E/5665/5667/5668
  • PXIe-5820/5840

Examples

Search within the programming environment to access the following installed examples:
  • RFSA Getting Started IQ
  • RFSA Getting Started Multi Record IQ
  • RFSA Acquire IQ Data in Blocks

Configuring the Device for Finite Acquisition

If you configure the device for finite acquisition, it acquires the specified number of samples and then stops the acquisition. You can configure the device to acquire multiple records using Configure Number of Records. Each record contains the number of samples specified in this node. The default number of records to acquire is 1.

Configuring the Device to Continuously Acquire Samples

If you configure the device to continuously acquire samples, it continues acquiring data until you call Abort to abort the acquisition. The device stores data in onboard memory in a circular fashion. After the device fills the memory, it starts overwriting previously acquired data from the beginning of the memory buffer. Retrieve the samples as they are being acquired using Fetch IQ to avoid overwriting data before you retrieve it.