RFSA C Reference

niRFSA_CreateDeembeddingSparameterTableS2PFile

  • Updated2025-02-03
  • 2 minute(s) read

niRFSA_CreateDeembeddingSparameterTableS2PFile

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

Purpose

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

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

Input
Name Type Description
vi ViSession Identifies your instrument session. vi is obtained from the niRFSA_init or niRFSA_InitWithOptions function.
port ViConstString Specifies the name of the port. The only valid value for the PXIe-5840/5841/5842/5860 is "" (empty string).
tableName 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 ViConstString Specifies the path to the S2P file that contains de-embedding information for the specified port.
sparameterOrientation ViInt32 Specifies the orientation of the data in the S2P file relative to the port on the DUT port.

NIRFSA_VAL_PORT1_TOWARDS_DUT (3800) Port 1 of the S2P is oriented towards the DUT port.
NIRFSA_VAL_PORT2_TOWARDS_DUT (3801) Port 2 of the S2P is oriented towards the DUT port.

Return Value

Name Type Description
status ViStatus 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

Log in to get a better experience