Getlocalcenterwave - JDS Uniphase SWS15100 User Manual

getLocalCenterWave

Description The getLocalCenterWave function calculates the center wavelength and its
corresponding power for the largest peak that is contained in the pPowData
array, within a specified wavelength range. This function must be called only
after the user has obtained the pPowData and pLamData arrays through a call
to the getILTrace function. The parameters refpeak and interLevel must be
supplied by the caller.
C prototype int getLocalCenterWave( double *pLamData, double *pPowData,
unsigned short dataSize, double dStartWave, double dStopWave, unsigned
short refpeak, double interLevel, unsigned short baseRef, double *pCenLam,
double *pCenPow );
VB prototype Declare Function getLocalCenterWave Lib "SWS15100" (ByRef pLamData As
Double, ByRef pPowData As Double, ByVal dataSize%, ByVal dStartWave As
Double, ByVal dStopWave As Double, 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 wavelength points of the trace.
double *pPowData:
The pPowData array stores IL power level (dB scale) points. 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.
double dStartWave:
This specifies the wavelength at which to start processing.
double dStopWave:
This specifies the wavelength at which to stop processing.
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
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.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com
Programming Guide – 147