Searching 2D histogram ranges - GNU Scientific Library -- Reference Manual
Description: GNU Scientific Library -- Reference Manual

Next: 2D Histogram Statistics, Previous: Updating and accessing 2D histogram elements, Up: Histograms

### 22.17 Searching 2D histogram ranges

The following functions are used by the access and update routines to locate the bin which corresponds to a given (x,y) coordinate.

— Function: int gsl_histogram2d_find (const gsl_histogram2d * h, double x, double y, size_t * i, size_t * j)

> This function finds and sets the indices i and j to the to the bin which covers the coordinates (x,y). The bin is located using a binary search. The search includes an optimization for histograms with uniform ranges, and will return the correct bin immediately in this case. If (x,y) is found then the function sets the indices (i,j) and returns `GSL_SUCCESS`. If (x,y) lies outside the valid range of the histogram then the function returns `GSL_EDOM` and the error handler is invoked.

The GNU Scientific Library - a free numerical library licensed under the GNU GPL
Back to the GNU Scientific Library Homepage