HAWKI Pipeline Reference Manual 1.8.12
Functions
Compute several statistics on images

Functions

double hawki_image_float_get_sigma_from_quartile (cpl_image *image)
 Get a robust estimation of the sigma based on the quartiles.
int hawki_image_stats_fill_from_frame (cpl_table **image_stats, const cpl_frame *frame, int irow)
 Fills a table with the statistics of the four detectors of a frame.
int hawki_image_stats_fill_from_image (cpl_table **image_stats, const cpl_image *image, int llx, int lly, int urx, int ury, int idet, int irow)
 Fills a table with the statistics of an image.
int hawki_image_stats_initialize (cpl_table **raw_stats)
 Initialize the table with all the statistics columns.
int hawki_image_stats_stats (cpl_table **image_stats, cpl_propertylist **stats_stats)
 Make the statistics (over image serie) of the each image statistics.

Function Documentation

double hawki_image_float_get_sigma_from_quartile ( cpl_image *  image)

Get a robust estimation of the sigma based on the quartiles.

Parameters:
imageThe image where to compute the statistic
Returns:
The sigma

Definition at line 582 of file hawki_image_stats.c.

int hawki_image_stats_fill_from_frame ( cpl_table **  image_stats,
const cpl_frame *  frame,
int  irow 
)

Fills a table with the statistics of the four detectors of a frame.

Parameters:
image_statsTable to fill with the statistics
frameThe target frame
llxLower left x position (FITS convention)
llyLower left y position (FITS convention)
urxUpper right x position (FITS convention)
uryUpper right y position (FITS convention)
irowThe row in the table to store the stats (begin in 0)
Returns:
0 if everything is ok, -1 otherwise

This function takes the rectangle of the image given by llx, lly, urx, ury and computes the image statistics. This statistics are stored in the four tables image_stats, one for each detector, using the columns MINIMUM, MAXIMUM, MEDIAN, MEAN, RMS, USED. The USED column is set to 1. The table must have already these columns (call hawki_image_stats_initialize before) The statistics are stored in the row irow.

Definition at line 430 of file hawki_image_stats.c.

References hawki_image_stats_fill_from_image(), and hawki_load_frame().

int hawki_image_stats_fill_from_image ( cpl_table **  image_stats,
const cpl_image *  image,
int  llx,
int  lly,
int  urx,
int  ury,
int  idet,
int  irow 
)

Fills a table with the statistics of an image.

Parameters:
image_statsTable to fill with the statistics
imageThe target image
llxLower left x position (FITS convention)
llyLower left y position (FITS convention)
urxUpper right x position (FITS convention)
uryUpper right y position (FITS convention)
idetThe id of the table to store the data in (0 to HAWKI_NB_DETECTORS)
irowThe row in the table to store the stats (begins in 0)
Returns:
0 if everything is ok, -1 otherwise

This function takes the rectangle of the image given by llx, lly, urx, ury and computes the image statistics. This statistics are stored in the table image_stats, using the columns MINIMUM, MAXIMUM, MEDIAN, MEAN, RMS, USED. The USED column is set to 1. The table must have already these columns (call hawki_image_stats_initialize before) The table used to store the data is image_stats[idet], in the row irow.

Definition at line 137 of file hawki_image_stats.c.

Referenced by hawki_image_stats_fill_from_frame().

int hawki_image_stats_initialize ( cpl_table **  raw_stats)

Initialize the table with all the statistics columns.

Parameters:
image_statsTable to fill with the statistics
Returns:
0 if everything is ok, -1 otherwise

This function creates the following columns in the given table: MINIMUM, MAXIMUM, MEDIAN, MEAN, RMS, USED

Definition at line 70 of file hawki_image_stats.c.

int hawki_image_stats_stats ( cpl_table **  image_stats,
cpl_propertylist **  stats_stats 
)

Make the statistics (over image serie) of the each image statistics.

Parameters:
stats_statsProperty list where to store the statistics
Returns:
0 if everything is ok, -1 otherwise

This function computes the mean, median, minimum, maximum and stdev of each of the columns found in the image_stats table.

Definition at line 512 of file hawki_image_stats.c.