Read-only
About Cal Sets

GetErrorTermByString Method


Description

Returns error term data from the Cal Set by specifying the string name of the error term.

 VB Syntax

pdata = calset.GetErrorTermByString(setNumber, errorTerm)

Variable

(Type) - Description

pdata

(Variant) Two-dimensional safe array to store the returned data. Memory for the returned Variant is allocated by the VNA and must be released by client.

Note: See also getErrorTermComplexByString on the ICalData3 interface to avoid using the variant data type.

calset

A Cal Set (object)

setNumber

(Long) Set number of the required Cal Set data.

See GetCalSetUsageInfo to determine the setNumber.

  • SetNumber 0 contains the original "primary" set of error terms for a Cal Set.

  • SetNumbers > 0 refers to the VNA channel number that contains the error terms. When retrieving channel error terms, Correction must be ON.

The channel error term data contains interpolation, fixturing, and port extension data if each is ON.

    • For Balanced Measurements, interpolation, fixturing, and port extensions can be ON independently.

    • For Standard S-parameters, to get port extension data, both fixturing and port extensions must be ON.

errorTerm

(String) The string name used to identify a particular error term in the Cal Set.  An example string for port 3 directivity in a full 2 port cal might be "Directivity(3,3)". To determine the string names of error terms, see GetErrorTermList2.

Return Type

Variant

Default

Not Applicable

Examples

See an Example

C++ Syntax

HRESULT GetErrorTermByString (long SetNumber, BSTR bufferName,  VARIANT* pdata);

Interface

ICalSet2