RFmxVnaMX.CalsetEmbedFixtureS2p Method
- Updated2024-07-17
- 2 minute(s) read
RFmx
Embeds the inverse of a given fixture network into a Calset in memory.
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 deembedding.
The fixture network must be known and the fixture S-parameters have to be provided as s2p-file.
A potential flip of the fixture network with respect to its S-parameter definitions can be configured by the S-Parameter Orientation.
The operation applies to one VNA port at a time, specified by VNA Port parameter.
Depending on the parameter New Calset Name, a new Calset will be created or the input Calset itself will be updated.
You cannot specify both signal name in Selector String and Calset Name together.
If you specify New Calset Name input, a new global calset will be created from original calset specified by Calset Name input and modified with embedding data. If you do not specify New Calset Name input, the original calset itself will be modified with embedding data.
If you do not specify both signal name in Selector String and Calset Name, original calset refers to in memory calset of default signal instance. If you do not specify Calset Name but specify signal name in Selector String, original calset refers to in memory calset of the specified signal instance. If you specify only Calset Name, original calset refers to the global calset with the specified Calset Name.
The fixture network must be known and the fixture S-parameters have to be provided as s2p-file.
A potential flip of the fixture network with respect to its S-parameter definitions can be configured by the S-Parameter Orientation.
The operation applies to one VNA port at a time, specified by VNA Port parameter.
Depending on the parameter New Calset Name, a new Calset will be created or the input Calset itself will be updated.
You cannot specify both signal name in Selector String and Calset Name together.
If you specify New Calset Name input, a new global calset will be created from original calset specified by Calset Name input and modified with embedding data. If you do not specify New Calset Name input, the original calset itself will be modified with embedding data.
If you do not specify both signal name in Selector String and Calset Name, original calset refers to in memory calset of default signal instance. If you do not specify Calset Name but specify signal name in Selector String, original calset refers to in memory calset of the specified signal instance. If you specify only Calset Name, original calset refers to the global calset with the specified Calset Name.
Namespace: NationalInstruments.RFmx.VnaMX
Assembly: NationalInstruments.RFmx.VnaMX.Fx40 (in NationalInstruments.RFmx.VnaMX.Fx40.dll) Version: 24.5.0.49286 (24.5.0.49286)
Syntax
public int CalsetEmbedFixtureS2p( string selectorString, string calsetName, string fixtureS2pFilePath, string vnaPort, RFmxVnaMXSParameterOrientation sParameterOrientation, string newCalsetName )
Public Function CalsetEmbedFixtureS2p ( selectorString As String, calsetName As String, fixtureS2pFilePath As String, vnaPort As String, sParameterOrientation As RFmxVnaMXSParameterOrientation, newCalsetName As String ) As Integer
Parameters
- selectorString String
- Pass an empty string. The signal name that is passed when creating the signal configuration is used.
- calsetName String
- Specifies the name of the calset.
- fixtureS2pFilePath String
- Specifies the path to the s2p file containing the fixture S-parameters.
- vnaPort String
- Specifies the port name of the Calset VNA port.
- sParameterOrientation RFmxVnaMXSParameterOrientation
- Specifies the orientation of the configured fixture network with respect to VNA port.
- newCalsetName String
- 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.
Return Value
Int32Returns the status code of this method. The status code either indicates success or describes a warning condition.