imageStats.hpp

Go to the documentation of this file.

// @copyright
// (c) Copyright ESO 2020
// All Rights Reserved
// ESO (eso.org) is an Intergovernmental Organization, and therefore special
// legal conditions apply.
//
// @file imageStats.hpp
// @brief Image analysis and statistic function declaration.
//
// This file is part of the DDT Image Handling Library and
// provides functions to analyse and calculate statistic values for CPL images.
//
// @author Christoph Bortlisz, CGI
// @since  2020/07/29
//
 
#ifndef IMAGESTATS_HPP_
#define IMAGESTATS_HPP_
 
//#include <algorithm>
//#include <cctype>
#include <list>
#include <vector>
 
//#include <sys/stat.h>
 
#include <cpl.h>
 
// namespace ddt {
 
typedef struct CplStatistics {
  double min_val;
  double max_val;
  double mean_val;
  double rms_val;
  int pix_num;
} CplStatistics;
 
const size_t MaxHistLength = 10000;
 
double MaxPixelCplImage(const cpl_image* const image);
 
double MaxPixelCplImageWindow(const cpl_image* const image, const int llx,
                              const int lly, const int urx, const int ury);
 
double MinPixelCplImage(const cpl_image* const image);
 
double MinPixelCplImageWindow(const cpl_image* const image, const int llx,
                              const int lly, const int urx, const int ury);
 
double MeanPixelCplImage(const cpl_image* const image);
 
double MeanPixelCplImageWindow(const cpl_image* const image, const int llx,
                               const int lly, const int urx, const int ury);
 
double RmsValueCplImage(const cpl_image* const image);
 
double RmsValueCplImageWindow(const cpl_image* const image, const int llx,
                              const int lly, const int urx, const int ury);
 
cpl_stats* StatsCplImage(const cpl_image* const image);
 
cpl_stats* StatsCplImageWindow(const cpl_image* const image, const int llx,
                               const int lly, const int urx, const int ury);
 
double RmsValueCplStats(const cpl_stats* const stats_cpl);
 
CplStatistics* StatisticsCplImage(const cpl_image* const image);
 
CplStatistics* StatisticsCplImageWindow(const cpl_image* const image,
                                        const int llx, const int lly,
                                        const int urx, const int ury);
 
CplStatistics* StatisticsCplStats(const cpl_stats* const stats_cpl);
 
bool FwhmValuesCplImage(const cpl_image* const image, const int x_pos,
                        const int y_pos, double* const fwhm_x,
                        double* const fwhm_y);
 
cpl_apertures* AperturesCplImage(const cpl_image* const image,
                                 const double sigma);
 
bool AperturesCplImageDump(const char* const file_name,
                           const cpl_apertures* const apertures);
 
bool MinMaxPixelsCplImage(const cpl_image* const image, double* const min,
                          double* const max);
 
bool MedianMinMaxPixelsCplImage(const cpl_image* const image, double* const min,
                                double* const max,
                                const double kernel_size = 5);
 
void CheckForNanValues(cpl_image* const image);
 
double PixelValueCplImage(const cpl_image* const image, const int x_pos,
                          const int y_pos, int* const is_rejected);
 
void GetHistogram(const cpl_image* const image, const int64_t min_value,
                  const int64_t max_value, std::vector<int>& distribution);
 
void GetHistogramBins(const cpl_image* const image, const int64_t min_value,
                      const int64_t max_value, std::vector<int>& distribution);
 
void GetCutValuesPercentage(const cpl_image* const image,
                            const double percentage, double* const min_value,
                            double* const max_value);
 
bool Get_IQE_Values(const cpl_image* const subImage, double* const x_axis_angle,
                    double* const background,
                    double* const peak_above_background, double* const fwhm_x,
                    double* const fwhm_y, double* const object_coord_x,
                    double* const object_coord_y);
 
bool MinMaxInvalidCheck(const cpl_image* const image, double* const min,
                        double* const max);
 
double SigmaCplImage(const cpl_image* const image, double* const sigma);
 
double SigmaCplImageWindow(const cpl_image* const image, const int llx,
                           const int lly, const int urx, const int ury,
                           double* const sigma);
//} // namespace ddt
 
#endif /* IMAGESTATS_HPP_ */