documentation.HELP! NI RF Vector Signal Analyzers Documentation

niRFSA Read IQ

NI RF Vector Signal Analyzers

previous page next page

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.

Select an instance niRFSA Read IQ (Complex WDT 1Rec 1Chan) niRFSA Read IQ (Complex Cluster 1Rec 1Chan)

niRFSA Read IQ (Complex WDT 1Rec 1Chan)

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

	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.
	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.
	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.
	error in (no error) describes error conditions that occur before this VI runs. 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. 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 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.
	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.
	data returns the baseband (downconverted) time-domain data for demodulation.
	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. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. 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. 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.

	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.
	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.
	error in (no error) describes error conditions that occur before this VI runs. 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. 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 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.
	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.
	data returns the acquired waveform. 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. dt returns the time interval between data points in the acquired signal. The IQ data sampling rate is the reciprocal of this value. 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.
	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. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. 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. 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.

previous page start next page

Get in touch

Submit feedback about this site to:

• [email protected]