Read-only
About Cal Sets

GetErrorTermStimulus Method


Description

Returns the stimulus values over which the specific error term was acquired.  For example, with mixer channels, you may get a different set of values for Directivity at the input port versus Directivity at the output port.

 VB Syntax

pdata = calset.GetErrorTermStimulus(setNumber, bufferName)

Variable

(Type) - Description

pdata

(Variant)  The VNA will allocate the memory for the returned variant.  The data is returned as a SafeArray of Variant elements.  Each element is of VarType double.

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 may be interpolated and may also be compensating for a fixture if that feature 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.

bufferName

(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

The sequence is:

complexData = calset1.GetErrorTermByString(0, BufferName)

frequencyData = calset1.GetErrorTermStimulus(0,BufferName)

// manipulate complex data here

Calset2.PutErrorTermByString(BufferName, manipulatedComplexData)

Calset2.PutErrorTermStimulus(BufferName, frequencyData);

See an Example

C++ Syntax

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

Interface

ICalSet7