Getcenterwave - JDS Uniphase SWS15100 User Manual

Function Description
calculated.
unsigned short baseRef:
This is Boolean. For minimum peaks, the baseRef is 1 and the bandwidth of
the peak is calculated from the base of the peak. For maximum peaks, the
baseRef is 0 and the bandwidth is calculated from the peak.
Output double *pBandwidth:
The pBandwidth stores the bandwidth of the peak.
Return Value When there is no error, the function returns zero.
When there is an error, the return value contains the error number.

getCenterWave

Function Description
Purpose The getCenterWave function calculates the center wavelength and its
corresponding power for the largest peak that is contained in the pPowData
array. This function must be called only after the user has obtained pPowData
and pLamData arrays through a call to the getILTrace function. The
parameters refpeak and interLevel are supplied by the caller.
C prototype int getCenterWave( double *pLamData, double *pPowData,
unsigned short dataSize, unsigned short refpeak, double interLevel,
unsigned short baseRef, double *pCenLam, double *pCenPow );
VB prototype Declare Function getCenterWave Lib "SWS15100" (ByRef pLamData As
Double, ByRef pPowData As Double, ByVal dataSize%, ByVal refPeak%,
ByVal InterLevel As Double, ByVal baseRef%, ByRef pCenLam As Double,
ByRef pCenPow 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 with the function
getDataSize.
unsigned short refpeak:
This is an integer type that has the following set of values:
{MAX_PEAK_REF = 0, MIN_PEAK_REF = 1}
double interLevel:
The interpolation level is the height from the peak where the bandwidth is
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com
Programming Guide – 137