niRFSA Read Power Spectrum (Cluster)

NI RF Vector Signal Analyzers

niRFSA Read Power Spectrum (Cluster)

Initiates a spectrum acquisition and returns power spectrum data.

niRFSA_Read_Power_Spectrum_(Cluster).gif
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 power spectrum returns power spectrum data.
idbl.gif f0 returns the start frequency of the spectrum, expressed in Hertz.
idbl.gif df returns the frequency interval between data points in the spectrum, expressed in Hertz
icclst.gif data returns the acquired data as a cluster.
idbl.gif t0 returns the trigger (start) time of the acquired signal.
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.