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.

Syntax

Namespace: NationalInstruments.RFmx.InstrMX

public int ConfigureSParameterExternalAttenuationTable(string selectorString, string tableName, double[] frequency, ComplexDouble[,,] sParameters, RFmxInstrMXSParameterOrientation sParameterOrientation)

Parameters

NameTypeDescription
selectorStringstring

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.</portname></calplanename>

Example:"""calplane::plane0""calplane::plane0/port::if0""port::if0""calplane::plane0/port::all"

tableNamestring

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.

frequencydouble[]

Specifies an array of frequencies in the S-parameter table. This value is expressed in Hz.

sParametersComplexDouble

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.

sParameterOrientationRFmxInstrMXSParameterOrientation

Specifies the orientation of the data in the S-parameter table relative to the port you specify.

Returns

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