RFmxInstrMX.ConfigureSParameterExternalAttenuationTable Method
- Updated2024-07-17
- 2 minute(s) read
RFmx
Stores the S-parameter table in the calibration plane specified by the selectorString parameter. On a MIMO session the S-parameter table is stored for each MIMO port in the specified calibration plane.
supporteddevices: PXIe-5830/5831/5832/5840/5841/5842/5860
If there is only one table configured in any calibration plane, it is automatically selected as the active table.
supporteddevices: PXIe-5830/5831/5832/5840/5841/5842/5860
If there is only one table configured in any calibration plane, it is automatically selected as the active table.
Namespace: NationalInstruments.RFmx.InstrMX
Assembly: NationalInstruments.RFmx.InstrMX.Fx40 (in NationalInstruments.RFmx.InstrMX.Fx40.dll) Version: 24.5.0.49285 (24.5.0.49285)
Syntax
public int ConfigureSParameterExternalAttenuationTable( string selectorString, string tableName, double[] frequency, ComplexDouble[,,] sParameters, RFmxInstrMXSParameterOrientation sParameterOrientation )
Public Function ConfigureSParameterExternalAttenuationTable ( selectorString As String, tableName As String, frequency As Double(), sParameters As ComplexDouble(,,), sParameterOrientation As RFmxInstrMXSParameterOrientation ) As Integer
Parameters
- selectorString String
-
Specifies the calibration plane name in which 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.
On a MIMO session if you do not specify the port name, this configuration is applied to all MIMO ports in the session for the default calibration plane instance. To configure S-parameter external attenuation table for a specific MIMO port, use the port specifier with or without the calplane name. Example: "calplane::plane1/port::myrfsa1/0".
Note
For PXIe-5830/5831/5832 devices, port names should also be specified along with Calplane names. Hence, the valid selector is "calplane::<calplaneName>/port::<portName>". If you specify "port::all", all ports are considered configured. For a MIMO port, the valid selector string is "calplane::(calplaneName)/port::(deviceName)/(channelNumber)/(portName)". If you specify "port::all", all MIMO ports are considered configured. Use RFmxInstrMX.GetAvailablePorts method to get the valid port names. Example:
""
"calplane::plane0"
"calplane::plane0/port::if0"
"port::if0"
"calplane::plane0/port::all"
- tableName String
- Specifies the name to be associated with S-parameter table within a calibration plane. Provide a unique name, such as "table1" to configure the table.
- frequency Double
-
Specifies an array of frequencies in the S-parameter table. This value is expressed in Hz.
- sParameters ComplexDouble
-
Specifies the S-parameters for each frequency. The first index indicates the corresponding frequency entry, the second index corresponds to the target port for the S-parameter, and the third index corresponds to the the source port. For example, to index the s21 parameter for the fourth frequency in the table, you would use {3, 1, 0} as the indexes since they are zero-based.
- sParameterOrientation RFmxInstrMXSParameterOrientation
- Specifies the orientation of the data in the S-parameter table relative to the port you specify.
Return Value
Int32Returns the status code of this method. The status code either indicates success or describes a warning condition.