Read-only |
About Source Power Cal |
Description |
Note: This method replaces getSourcePowerCalDataScalar Method Retrieves (as scalar values) source power calibration data, if it exists, from this channel. If the channel is sweeping the source backwards, then the first data point is the highest frequency value; the last data point is the lowest. Use the Get X-Axis Values2 command to return the X-axis values in the displayed order. Note: This method exists on a non-default interface. If you cannot access this method, use the getSourcePowerCalDataEx Method on IChannel4. |
VB Syntax |
chanData.getSourcePowerCalDataScalarEx buffer, srcPort, numValues, data |
Variable |
(Type) - Description |
chanData |
(interface) – An ISourcePowerCalData2 interface on the Channel object. |
buffer |
(enum NASourcePowerCalBuffer) - The requested source power cal data buffer. 0 - naCorrectionValues Last iteration of Cal data. 1 - naPriorIterationCorrectionValues Prior iteration of Cal data. This argument can be used to determine the final power reading at each point of the power cal, for a cal that did not pass tolerance limits. The following formula can be used to determine the power reading (in dB): Power reading = Target power at the source port + specified power cal offset value + ‘prior’ iteration corr value – actual power corr value. The "actual" value in this equation is returned with naCorrectionValues. |
srcPort |
(long integer) – The source port for which calibration data is being requested. Note: If the port is defined by a string name, such as an external source, a balanced port, or one of the Source 2 outputs on the 2-port 2-source VNA-x model, then you must use chan.getPortNumber to translate the string into a port number. To learn more see Remotely Specifying a Source Port. |
numValues |
(long integer) – Number of data values. [out] – specifies number of data values returned. [in] – specifies number of values being requested (this must not be larger than the capacity of the data array). |
data |
(single) – Array to store the data. |
Return Type |
Single |
Default |
Not Applicable |
Examples |
Dim numValues As Long |
C++ Syntax |
HRESULT getSourcePowerCalDataScalarEx(tagNASourcePowerCalBuffer bufSelect, long sourcePort, long *pNumValues, float *pData); |
Interface |
ISourcePowerCalData2 |