Creates an S-parameter de-embedding table for the port based on the specified S2P file.

Syntax

ViStatus _VI_FUNC niRFSA_CreateDeembeddingSparameterTableS2PFile(ViSession vi, ViConstString port, ViConstString tableName, ViConstString s2pFilePath, ViInt32 sparameterOrientation)

Remarks

If you only create one table for a port, NI-RFSA automatically selects that table to de-embed the measurement.

Supported Devices: PXIe-5830/5831/5832/5840/5841/5842/5860

Related Topics

De-embedding Overview

S-parameters

Parameters

NameDirectionTypeDescription
vi[in]ViSession

Identifies your instrument session. vi is obtained from the niRFSA_Init or niRFSA_InitWithOptions function.

port[in]ViConstString

Specifies the name of the port. The only valid value for the PXIe-5840/5841/5842/5860 is "" (empty string).

tableName[in]ViConstString

Specifies the name of the table. The name must be unique for a given port, but not across ports. If you use the same name as an existing table, the table is replaced.

s2pFilePath[in]ViConstString

Specifies the path to the S2P file that contains de-embedding information for the specified port.

sparameterOrientation[in]ViInt32

Specifies the orientation of the data in the S2P file relative to the port on the DUT port.

Name

Value

Description

NIRFSA_VAL_PORT1_TOWARDS_DUT

3800 (0xed8)

Port 1 of the S2P is oriented towards the DUT port.

NIRFSA_VAL_PORT2_TOWARDS_DUT

3801 (0xed9)

Port 2 of the S2P is oriented towards the DUT port.

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 NI-RFSA 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 niRFSA_GetError function. To clear the error information from NI-RFSA, call the niRFSA_ClearError function. The general meaning of the status code is as follows:

Value

Meaning

0

Success

Positive Values

Warnings

Negative Values

Errors