Functions | |
double | cpl_image_get_absflux (const cpl_image *image) |
Computes the sum of absolute values over an image. | |
double | cpl_image_get_absflux_window (const cpl_image *image, int llx, int lly, int urx, int ury) |
Computes the sum of absolute values over an image sub-window. | |
double | cpl_image_get_centroid_x (const cpl_image *image) |
Computes the x centroid value over the whole image. | |
double | cpl_image_get_centroid_x_window (const cpl_image *image, int llx, int lly, int urx, int ury) |
Computes the x centroid value over an image sub-window. | |
double | cpl_image_get_centroid_y (const cpl_image *image) |
Computes the y centroid value over the whole image. | |
double | cpl_image_get_centroid_y_window (const cpl_image *image, int llx, int lly, int urx, int ury) |
Computes the y centroid value over an image sub-window. | |
double | cpl_image_get_flux (const cpl_image *image) |
Computes the sum of pixel values over an image. | |
double | cpl_image_get_flux_window (const cpl_image *image, int llx, int lly, int urx, int ury) |
Computes the sum of pixel values over an image sub-window. | |
double | cpl_image_get_max (const cpl_image *image) |
computes maximum pixel value over an image. | |
double | cpl_image_get_max_window (const cpl_image *image, int llx, int lly, int urx, int ury) |
computes maximum pixel value over an image sub-window. | |
cpl_error_code | cpl_image_get_maxpos (const cpl_image *image, int *px, int *py) |
Computes maximum pixel value and position over an image. | |
cpl_error_code | cpl_image_get_maxpos_window (const cpl_image *image, int llx, int lly, int urx, int ury, int *px, int *py) |
Computes maximum pixel value and position over an image sub window. | |
double | cpl_image_get_mean (const cpl_image *image) |
computes mean pixel value over an image. | |
double | cpl_image_get_mean_window (const cpl_image *image, int llx, int lly, int urx, int ury) |
computes mean pixel value over an image sub-window. | |
double | cpl_image_get_median (const cpl_image *image) |
computes median pixel value over an image. | |
double | cpl_image_get_median_dev (const cpl_image *image, double *sigma) |
Computes first and second order image statistics using median. | |
double | cpl_image_get_median_dev_window (const cpl_image *image, int llx, int lly, int urx, int ury, double *sigma) |
Computes first and second order image statistics using median. | |
double | cpl_image_get_median_window (const cpl_image *image, int llx, int lly, int urx, int ury) |
computes median pixel value over an image sub-window. | |
double | cpl_image_get_min (const cpl_image *image) |
computes minimum pixel value over an image. | |
double | cpl_image_get_min_window (const cpl_image *image, int llx, int lly, int urx, int ury) |
computes minimum pixel value over an image sub-window. | |
cpl_error_code | cpl_image_get_minpos (const cpl_image *image, int *px, int *py) |
Computes minimum pixel value and position over an image. | |
cpl_error_code | cpl_image_get_minpos_window (const cpl_image *image, int llx, int lly, int urx, int ury, int *px, int *py) |
Computes minimum pixel value and position over an image sub window. | |
double | cpl_image_get_sqflux (const cpl_image *image) |
Computes the sum of squared values over an image. | |
double | cpl_image_get_sqflux_window (const cpl_image *image, int llx, int lly, int urx, int ury) |
Computes the sum of squared values over an image sub-window. | |
double | cpl_image_get_stdev (const cpl_image *image) |
computes pixel standard deviation over an image. | |
double | cpl_image_get_stdev_window (const cpl_image *image, int llx, int lly, int urx, int ury) |
computes pixel standard deviation over an image sub-window. |
The bad pixel map stored in the image is taken into account for the statistics computations. These functions can compute the mean, median, maximum, minimum, flux, etc... of the good pixels of an image.
#include "cpl_image_stats.h"
double cpl_image_get_absflux | ( | const cpl_image * | image | ) |
Computes the sum of absolute values over an image.
image | input image. |
double cpl_image_get_absflux_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury | |||
) |
Computes the sum of absolute values over an image sub-window.
image | input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) |
double cpl_image_get_centroid_x | ( | const cpl_image * | image | ) |
Computes the x centroid value over the whole image.
image | input image. |
double cpl_image_get_centroid_x_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury | |||
) |
Computes the x centroid value over an image sub-window.
image | input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) |
double cpl_image_get_centroid_y | ( | const cpl_image * | image | ) |
Computes the y centroid value over the whole image.
image | input image. |
double cpl_image_get_centroid_y_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury | |||
) |
Computes the y centroid value over an image sub-window.
image | input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) |
double cpl_image_get_flux | ( | const cpl_image * | image | ) |
Computes the sum of pixel values over an image.
image | input image. |
double cpl_image_get_flux_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury | |||
) |
Computes the sum of pixel values over an image sub-window.
image | input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) |
double cpl_image_get_max | ( | const cpl_image * | image | ) |
computes maximum pixel value over an image.
image | input image. |
double cpl_image_get_max_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury | |||
) |
computes maximum pixel value over an image sub-window.
image | input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) |
cpl_error_code cpl_image_get_maxpos | ( | const cpl_image * | image, | |
int * | px, | |||
int * | py | |||
) |
Computes maximum pixel value and position over an image.
image | Input image. | |
px | ptr to the x coordinate of the maximum position | |
py | ptr to the y coordinate of the maximum position |
cpl_error_code cpl_image_get_maxpos_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury, | |||
int * | px, | |||
int * | py | |||
) |
Computes maximum pixel value and position over an image sub window.
image | Input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) | |
px | ptr to the x coordinate of the maximum position | |
py | ptr to the y coordinate of the maximum position |
double cpl_image_get_mean | ( | const cpl_image * | image | ) |
computes mean pixel value over an image.
image | input image. |
double cpl_image_get_mean_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury | |||
) |
computes mean pixel value over an image sub-window.
image | input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) |
double cpl_image_get_median | ( | const cpl_image * | image | ) |
computes median pixel value over an image.
image | Input image. |
Possible _cpl_error_code_ set in this function:
double cpl_image_get_median_dev | ( | const cpl_image * | image, | |
double * | sigma | |||
) |
Computes first and second order image statistics using median.
image | Input image. | |
sigma | Output computed sigma value. |
Possible _cpl_error_code_ set in this function:
double cpl_image_get_median_dev_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury, | |||
double * | sigma | |||
) |
Computes first and second order image statistics using median.
image | Input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) | |
sigma | Output computed sigma value. |
Possible _cpl_error_code_ set in this function:
double cpl_image_get_median_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury | |||
) |
computes median pixel value over an image sub-window.
image | Input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) |
In case of error, the _cpl_error_code_ code is set, and the returned value is undefined. Images can be CPL_TYPE_FLOAT, CPL_TYPE_INT or CPL_TYPE_DOUBLE.
For a finite population or sample, the median is the middle value of an odd number of values (arranged in ascending order) or any value between the two middle values of an even number of values. In case of an even number of values in the input array, the median is chosen to be the lower of the two central values - this ensures that the computed median is always among the values of the input arrays.
Possible _cpl_error_code_ set in this function:
double cpl_image_get_min | ( | const cpl_image * | image | ) |
computes minimum pixel value over an image.
image | input image. |
Possible _cpl_error_code_ set in this function:
double cpl_image_get_min_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury | |||
) |
computes minimum pixel value over an image sub-window.
image | input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) |
Images can be CPL_TYPE_FLOAT, CPL_TYPE_INT or CPL_TYPE_DOUBLE.
Possible _cpl_error_code_ set in this function:
cpl_error_code cpl_image_get_minpos | ( | const cpl_image * | image, | |
int * | px, | |||
int * | py | |||
) |
Computes minimum pixel value and position over an image.
image | Input image. | |
px | ptr to the x coordinate of the minimum position | |
py | ptr to the y coordinate of the minimum position |
Possible _cpl_error_code_ set in this function:
cpl_error_code cpl_image_get_minpos_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury, | |||
int * | px, | |||
int * | py | |||
) |
Computes minimum pixel value and position over an image sub window.
image | Input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) | |
px | ptr to the x coordinate of the minimum position | |
py | ptr to the y coordinate of the minimum position |
Images can be CPL_TYPE_FLOAT, CPL_TYPE_INT or CPL_TYPE_DOUBLE.
Possible _cpl_error_code_ set in this function:
double cpl_image_get_sqflux | ( | const cpl_image * | image | ) |
Computes the sum of squared values over an image.
image | input image. |
double cpl_image_get_sqflux_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury | |||
) |
Computes the sum of squared values over an image sub-window.
image | input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) |
double cpl_image_get_stdev | ( | const cpl_image * | image | ) |
computes pixel standard deviation over an image.
image | input image. |
double cpl_image_get_stdev_window | ( | const cpl_image * | image, | |
int | llx, | |||
int | lly, | |||
int | urx, | |||
int | ury | |||
) |
computes pixel standard deviation over an image sub-window.
image | input image. | |
llx | Lower left x position (FITS convention) | |
lly | Lower left y position (FITS convention) | |
urx | Upper right x position (FITS convention) | |
ury | Upper right y position (FITS convention) |