Getbandwidth - JDS Uniphase SWS15100 User Manual

Function Description
{MAX_PEAK_REF = 0(find maximum peaks),
MIN_PEAK_REF = 1(find minimum peaks)}
Output unsigned short *peakIndex:
This is the position of the peak in the pPowData array.
double *pPowPeak:
This is the power of the peak, the maximum power of the pPowData array.
double *pLamPeak:
This is the wavelength of the peak that corresponds to the pPowPeak value.
Return Value When there is no error, the function returns zero.
When there is an error, the return value contains the error number.

getBandwidth

Function Description
Purpose The getBandwidth function calculates the bandwidth of the largest peak that is
contained in the pPowData power array. Call this function only after obtaining
the pPowData array through a call to the getILTrace function. The
characteristics of the peak as refpeak, interLevel, and baseref must be filled by
the caller.
C prototype int getBandwidth(double *pLamData, double *pPowData,
unsigned short dataSize, unsigned short refpeak,
double interLevel, unsigned short baseRef, double *pBandwidth );
VB prototype Declare Function getBandwidth Lib "SWS15100" (ByRef pLamData As
Double, ByRef pPowData As Double, ByVal dataSize%, ByVal refPeak%,
ByVal InterLevel As Double, ByVal baseRef%, ByRef pBandwidth 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, and
is the size of the acquired trace returned by 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
136 – Programming Guide
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com