niRFSA Fetch IQ

Transfers acquired waveform data from device memory to PC memory. The data was acquired to onboard memory previously by the hardware after it was initiated. If the number of samples specified in samples to read is not available after the time duration specified in timeout, this VI returns no data with a timeout error.

This VI is not necessary if you use the niRFSA Read IQ VI, as the fetch is performed as part of that function.

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

Select an instance niRFSA Fetch IQ (Complex WDT 1Rec 1Chan) niRFSA Fetch IQ (Complex Cluster 1Rec 1Chan) niRFSA Fetch IQ (1D I16) niRFSA Fetch IQ (1D Complex WDT NRec 1Chan) niRFSA Fetch IQ (1D Complex Cluster NRec 1Chan) niRFSA Fetch IQ (2D I16)

niRFSA Fetch IQ (Complex WDT 1Rec 1Chan)

Fetches IQ data from a single record in an acquisition.

	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.
	samples to read specifies the number of samples to fetch. A value of -1 specifies that NI-RFSA fetch all samples.
	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. A value of 0 specifies the VI returns available data immediately.
	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.
	record to fetch specifies the record to retrieve. Record numbers are zero-indexed.
	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 Fetch IQ (Complex Cluster 1Rec 1Chan)

Fetches IQ data from a single record in an acquisition.

	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.
	samples to read specifies the number of samples to fetch. A value of -1 specifies that NI-RFSA fetch all samples.
	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. A value of 0 specifies the VI returns available data immediately.
	record to fetch specifies the record to retrieve. Record numbers are zero-indexed.
	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 data as a cluster. 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.

niRFSA Fetch IQ (1D I16)

Fetches binary IQ data from a single record in an acquisition.

	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.
	samples to read specifies the number of samples to fetch. A value of -1 specifies that NI-RFSA fetch all samples.
	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. A value of 0 specifies the VI returns available data immediately.
	record to fetch specifies the record to retrieve. Record numbers are zero-indexed.
	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 complex waveform. The array is composed of interleaved I and Q samples, where the order of the array is as shown: Array[0] = I0 Array[1] = Q0 Array[2] = I1 Array[3] = Q1
	wfm info contains the absolute and relative timestamp for the operation, the dt, and the actual number of samples read. absolute timestamp Specifies the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions. relative timestamp returns a timestamp that 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. actual samples read returns an integer representing the number of samples in the waveform offset specifies the offset to scale data in mx+b form. gain specifies the gain to scale data in mx+b form.
	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 Fetch IQ (1D Complex WDT NRec 1Chan)

Fetches IQ data from a single record in an acquisition.

	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.
	samples to read specifies the number of samples to fetch. A value of -1 specifies that NI-RFSA fetch all samples.
	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. A value of 0 specifies the VI returns available data immediately.
	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.
	number of records specifies the number of records to fetch. A value of -1 specifies that NI-RFSA fetches all records in an acquisition starting with the record specified by starting record. Record numbers are zero-indexed.
	starting record specifies the first record to retrieve.
	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.
	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 Fetch IQ (1D Complex Cluster NRec 1Chan)

Fetches IQ data from multiple records in an acquisition.

	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.
	samples to read specifies the number of samples to fetch. A value of -1 specifies that NI-RFSA fetch all samples.
	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. A value of 0 specifies the VI returns available data immediately.
	number of records specifies the number of records to fetch. A value of -1 specifies that NI-RFSA fetches all records in an acquisition starting with the record specified by starting record. Record numbers are zero-indexed.
	starting record specifies the first record to retrieve.
	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 data as a cluster. 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.

niRFSA Fetch IQ (2D I16)

Fetches binary IQ data from multiple records in an acquisition.

	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.
	samples to read specifies the number of samples to fetch. A value of -1 specifies that NI-RFSA fetch all samples.
	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. A value of 0 specifies the VI returns available data immediately.
	number of records specifies the number of records to fetch. A value of -1 specifies that NI-RFSA fetches all records in an acquisition starting with the record specified by starting record. Record numbers are zero-indexed.
	starting record specifies the first record to retrieve.
	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 complex waveform per record. Each record occupies a row of the 2D array. A record is composed of interleaved I and Q samples, where the order of the array is as shown: Array[0] = I0 Array[1] = Q0 Array[2] = I1 Array[3] = Q1
	wfm info contains the absolute and relative timestamp for the operation, the dt, and the actual number of samples read. absolute timestamp Specifies the timestamp in seconds of the first fetched sample that is comparable between records and acquisitions. relative timestamp returns a timestamp that 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. actual samples read returns an integer representing the number of samples in the waveform offset specifies the offset to scale data in mx+b form. gain specifies the gain to scale data in mx+b form.
	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.