RFmx Instr DotNET

Table of Contents

RFmxInstrMX.ConfigureSParameterExternalAttenuationTable Method

  • Updated2024-07-17
  • 2 minute(s) read
RFmxInstrMX.ConfigureSParameterExternalAttenuationTable Method

RFmxInstrMXConfigureSParameterExternalAttenuationTable Method

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.

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  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

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

See Also

Log in to get a better experience