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 PNA 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 "master" set of error terms for a Cal Set.

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

New beginning PNA Rev 7.2: 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