---

Histogram.h

Go to the documentation of this file.

/*************************************************************************
 *
 * Source code for Real Time Image Library (libRTImage)
 *
 * Leeds Vision Group give permission for this code to be copied, modified
 * and distributed within the University of Leeds subject to the following
 * conditions:-
 *
 * - The code is not to be used for commercial gain.
 * - The code and use thereof will be attributed to the authors where
 *   appropriate (including demonstrations which rely on it's use).
 * - All modified, distributions of the source files will retain this header.
 *
 ****************************************************************************/

#ifndef HISTOGRAM_H
#define HISTOGRAM_H

class Histogram
{
private:
    float                  min_val;         
    float                  max_val;         
    unsigned int           bands_per_dim;   
    unsigned int           dim;             
    unsigned int          *frequency_data;  
    unsigned int           no_bins;         
    unsigned int           no_data_items;   
    float                  band_size;       

    float                  max_prob;        
    unsigned int           max_freq;        
    
protected:
    float                 *probs;           
    
public:
    Histogram(float        minimum_data_value,
              float        maximum_data_value,
              unsigned int bands_per_dimension,
              unsigned int dimensionality);

    Histogram(char const* hstFile);

    unsigned int numBands (void)  { return bands_per_dim; }
    
    void        add_new_data_item (int *data); 
    void        add_new_data_item (float *data); 
    
    void        reset_histogram();
    void        calculate_probabilities();
    void        calculate_histogram();

    float       get_histogram_value  (unsigned int *bin); 
    float       get_mapped_value     (unsigned int *bin);
        
    float       calculate_difference (Histogram *hist);

    float       get_maximum_prob     (void) { return max_prob; }

    void        get_best_bin(unsigned int *bin) ;

    float       calculate_proportion_threshold(float proportion) ;

    void        save_histogram(char const*);
    void        load_histogram(char const*);
};

#endif

---