JDS Uniphase SWS15100 - Getpeakpower

To Next Page

To Previous Page

Programming Guide – 135

Function Description

Output double *pLamData:

The pLamData array stores wavelength for each data point in the trace. The

function updates the array and the pointer to the array is passed as input.

double *pPowData:

The pPowData array stores the IL power level (dB scale). Each value from

pPowData array has a corresponding wavelength value in the pLamData

array. The function updates the array and the pointer to the array must be

passed as input.

short *pola:

The function returns the polarization of the current processed trace.

Return Value When there is no error, the function returns zero.

When there is an error, the return value contains the error number.

getPeakPower

Function Description

Purpose The getPeakPower function retrieves the power of the largest peak that is

contained in the pPowData power array. Call the function after obtaining

pPowData data through a call to the getILTrace function. The refpeak

parameter must be filled by the caller.

C prototype int getPeakPower( double *pLamData, double *pPowData, unsigned short

dataSize, unsigned short refpeak, unsigned short *peakIndex, double

*pPowPeak, double *pLamPeak );

VB prototype Declare Function getPeakPower Lib "SWS15100" (ByRef pLamData As

Double, ByRef pPowData As Double, ByVal dataSize%, ByVal refPeak%,

ByRef PeakIndex%, ByRef pPowPeak As Double, ByRef pLamPeak As

Double) As Long

Input double *pLamData:

The pLamData array stores the wavelength for each data point in the trace.

double *pPowData:

The pPowData array stores the measured power levels (dB scale) for each

point in the trace. Each point from the pPowData array has a corresponding

point in the pLamData array.

unsigned short dataSize:

This is the size of arrays pLamData and pPowData allocated by the user. This

is the size of the acquired trace retrieved by the user using the function

getDataSize.

unsigned short refpeak:

This is an integer set of values:

Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com