niRFSA Read IQ

NI RF Vector Signal Analyzers

niRFSA Read IQ

Initiates an acquisition and fetches a single IQ data record. Do not use this VI if you have configured the device to continuously acquire data samples or to acquire multiple records.

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

niRFSA Read IQ (Complex WDT 1Rec 1Chan)

Returns the IQ data as a complex waveform data type (WDT).

cio.gif instrument handle identifies your instrument session. instrument handle is obtained from the niRFSA Initialize or the niRFSA Initialize With Options VIs and identifies a particular instrument session.
cdbl.gif timeout specifies in seconds the time allotted for the function to complete before returning a timeout error. A value of -1 specifies the VI waits until all data is available.
cenum.gif timestamp type specifies the time format of the data.
Relative When converted to a DBL value, the timestamp corresponds to the difference in seconds between the first sample returned and the Reference trigger location.
Absolute The timestamp corresponds to the date and time of the acquisition of the first sample returned.
ccclst.gif error in (no error) describes error conditions that occur before this VI runs.
cbool.gif status is TRUE (X) if an error occurred before this VI ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI ran. The default is FALSE.
ci32.gif 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.
cstr.gif source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning. The default is an empty string.
iio.gif instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niRFSA Initialize or the niRFSA Initialize With Options VIs and identifies a particular instrument session.
iwfm.gif data returns the baseband (downconverted) time-domain data for demodulation.
icclst.gif error out contains error information. If error in indicates that an error occurred before this VI ran, error out contains the same error information. Otherwise, it describes the error status that this VI produces.
ibool.gif status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
ii32.gif code the error or warning code. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.
istr.gif source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning.

niRFSA Read IQ (Complex Cluster 1Rec 1Chan)

Returns the IQ data as a complex cluster.

cio.gif instrument handle identifies your instrument session. instrument handle is obtained from the niRFSA Initialize or the niRFSA Initialize With Options VIs and identifies a particular instrument session.
cdbl.gif timeout specifies in seconds the time allotted for the function to complete before returning a timeout error. A value of -1 specifies the VI waits until all data is available.
ccclst.gif error in (no error) describes error conditions that occur before this VI runs.
cbool.gif status is TRUE (X) if an error occurred before this VI ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI ran. The default is FALSE.
ci32.gif 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.
cstr.gif source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning. The default is an empty string.
iio.gif instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the niRFSA Initialize or the niRFSA Initialize With Options VIs and identifies a particular instrument session.
icclst.gif data returns the acquired waveform.
idbl.gif t0 returns the trigger (start) time of the acquired signal. The timestamp corresponds to the difference in seconds between the first sample returned and the Reference trigger location.
idbl.gif dt returns the time interval between data points in the acquired signal. The IQ data sampling rate is the reciprocal of this value.
i1dcdb.gif Y returns the complex-valued time domain data array. The real and imaginary parts of this complex data array correspond to the in-phase (I) and quadrature-phase (Q) data, respectively. To calculate the instantaneous power of a sampled IQ point, use the equation (I 2 + Q 2)/2R, where R is the input impedance in ohms. For NI RF signal analyzers, R = 50 ohms.
icclst.gif error out contains error information. If error in indicates that an error occurred before this VI ran, error out contains the same error information. Otherwise, it describes the error status that this VI produces.
ibool.gif status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
ii32.gif code the error or warning code. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.
istr.gif source describes the origin of the error or warning and is, in most cases, the name of the VI that produced the error or warning.