Selects the linear interpolation method when interpolating S-parameters for the specified table. If the carrier frequency does not match a row in the S-parameter table, this function performs a linear interpolation based on the entries above and below the row in the table.

Note

Currently interpolation is supported only for S-parameter tables.

Syntax

int32 __stdcall RFmxInstr_CfgExternalAttenuationInterpolationLinear(niRFmxInstrHandle instrumentHandle, char selectorString[], char tableName, int32 format)

Remarks

Supported devices: PXIe-5663/5663E, PXIe-5665, PXIe-5668, PXIe-5644/5645/5646, PXIe-5830/5831/5832/5840/5841/5842/5860

Parameters

NameDirectionTypeDescription
instrumentHandle[in]niRFmxInstrHandle

This parameter identifies the instrument session. This parameter is obtained from the RFmxInstr_Initialize function or the RFmxInstr_InitializeFromNIRFSASessionArray function.

selectorString[in]char

This parameter specifies the calibration plane name in which either S-parameter or external attenuation table is stored. This input accepts the calibration plane name with the "calplane::" prefix. If you do not specify the calibration plane name, the default calibration plane instance is used. The default value is "" (empty string).
Note

For PXIe-5830/5831/5832 devices, port names should also be specified along with Calplane names. Hence, the valid selector string is "calplane::<calplanename>/port::<portname>". If you specify "port::all", all ports are considered configured. Use RFmxInstr_GetAvailablePorts function to get the valid port names.</portname></calplanename>

Example:
""
"calplane::plane0"
"calplane::plane0/port::if0"
"port::if0"
"calplane::plane0/port::all"

tableName[in]char

This parameter specifies the name to be associated with either the S-parameter table or the external attenuation table within a calibration plane. Provide a unique name, such as "table1" to configure the table. The default value is "" (empty string). Example:
""
"table1"

format[in]int32

This parameter specifies the format of parameters to interpolate. The default value is Real and Imaginary.

Name (Value)

Description

Real and Imaginary (0)

Results in a linear interpolation of the real portion of the complex number and a separate linear interpolation of the complex portion.

Magnitude and Phase (1)

Results in a linear interpolation.

Magnitude and Phase (dB) (2)

Results in a linear interpolation.

Returns

Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. Examine the status code from each call to an RFmx function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the RFmxInstr_GetError function.

The general meaning of the status code is as follows:

Value

Meaning

0

Success

Positive Values

Warnings

Negative Values

Errors