imaqDetectExtremes
Usage
ExtremeReport* imaqDetectExtremes(const double* pixels, int numPixels, DetectionMode mode, const DetectExtremesOptions* options, int* numExtremes);
Purpose
Finds the location, amplitude, and second derivative of the extremes (either peaks or valleys) in the input array. This function uses an algorithm that fits a quadratic polynomial to sequential groups of data points.
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| pixels | const double* | The array of pixel data the function processes. |
| numPixels | int | The number of pixels in the supplied array. You must supply at least as many pixels as the value you supply for the width element in the options parameter. |
| mode | DetectionMode | Determines if the function detects peaks or detects valleys. |
| options | const DetectExtremesOptions* | Describes how the function calculates the extremes. |
| numExtremes | int* | On return, the number of extremes found by the function. Set this parameter to NULL if you do not need this information. |
Return Value
| Type |
Description |
|---|---|
| ExtremeReport* | On success, this function returns an array of information about each extreme found. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with the return value, dispose of the pointer by calling imaqDispose(). |
Parameter Discussion
options—Set options to NULL to use the default options, as follows:
| threshold | 0 |
| width | 3 |