Embeds the inverse of a given fixture network into a specified calset.
The typical use case for this utility is to remove the effect of an adapter that was present during calibration but is not present during later measurements from the Calset itself such that corrected measurements can be performed without considering the calibration adapter in the measurement de-embedding.

Syntax

Namespace: NationalInstruments.RFmx.VnaMX

public int CalsetEmbedFixtureS2p(string selectorString, string calsetName, string fixtureS2pFilePath, string vnaPort, RFmxVnaMXSParameterOrientation sParameterOrientation, string newCalsetName)

Remarks

Behaviors for different combinations of New Calset Name, Calset Name and Signal Name strings are as follows:

  • Both Calset Name and New Calset Name are "" (empty string): RFmx modifies the default calset of the signal instance specified in the Selector String, with embedding data. If you do not specify a Signal Name, then default RFmxVNA signal instance is used.

  • Calset Name is "" (empty string) and New Calset Name is non-empty string: RFmx creates a new named calset with the name specified by New Calset Name from the default calset of the signal instance specified in the Selector String and modifies the new named calset with embedding data. This newly created named calset is made accessible across all signals. If you do not specify a Signal Name, then default RFmxVNA signal instance is used.

  • Calset Name is non-empty string and New Calset Name is "" (empty string): If you do not specify a Signal Name, then RFmx modifies the existing named calset with embedding data. RFmx returns an error if you specify both Calset Name and Signal Name as non-empty strings.

  • Both Calset Name and New Calset Name are non-empty string: If you do not specify a Signal Name, then RFmx creates a new named calset with the name specified by New Calset Name from the existing named calset specified by Calset Name and modifies the new named calset with embedding data. RFmx returns an error if you specify both Calset Name and Signal Name as non-empty strings.

Parameters

NameTypeDescription
selectorStringstring

Pass an empty string. The signal name that is passed when creating the signal configuration is used.

calsetNamestring

Specifies the name of the calset.

fixtureS2pFilePathstring

Specifies the path to the s2p file containing the fixture S-parameters.

vnaPortstring

Specifies the port name of the Calset VNA port.

sParameterOrientationRFmxVnaMXSParameterOrientation

Specifies the orientation of the configured fixture network with respect to VNA port.

newCalsetNamestring

Specifies the name under which the result Calset (with updated error coefficients) is to be saved. If empty string is provided, the updated Calset is saved back into the original Calset. That is, the original Calset is overwritten.

Returns

Returns the status code of this method. The status code either indicates success or describes a warning condition.