StatEntity.h

Go to the documentation of this file.

// $Id: StatEntity.h,v 1.7 2007/08/06 08:39:40 marcocle Exp $ 
// ============================================================================
// CVS tag $Name:  $, version $Revision: 1.7 $
// ============================================================================
#ifndef   GAUDIKERNEL_STATENTITY_H
#define   GAUDIKERNEL_STATENTITY_H 1 
// ============================================================================
// Include files 
// ============================================================================
// STD & STL 
// ============================================================================
#include <string>
#include <iostream>
// ============================================================================
class StatEntity
{
public:
  StatEntity  () { reset() ; }
  /* The full contructor from all important values:
   * @attention it need to be coherent with 
   *            the actual structure of the class 
   *            and the format description
   *  @see StatEntity::format
   *  @param entries number of entries 
   *  @param flag  accumulated flag 
   *  @param flag2 accumulated statistics: flag**2
   *  @param minFlag the minimun value for flag
   *  @param maxFlag the maximum value for flag
   */
  StatEntity ( const unsigned long entries , 
               const double        flag    ,
               const double        flag2   ,
               const double        minFlag , 
               const double        maxFlag ) ;              
  ~StatEntity () {}
public:
  static const std::string& format () ;
  static int                size  () ;
public:
  unsigned long nEntries           () const { return m_se_nEntries         ; }
  // "flag" statistics:
  double   flag               () const { return m_se_accumulatedFlag  ; }
  double   flag2              () const { return m_se_accumulatedFlag2 ; }
  double   flagMean           () const ; 
  double   flagRMS            () const ;
  double   flagMeanErr        () const ;
  double   flagMin            () const { return m_se_minimalFlag      ; }
  double   flagMax            () const { return m_se_maximalFlag      ; }
  double efficiency () const ;
  double efficiencyErr () const ;  
  double eff           () const { return efficiency    () ; }
  double effErr        () const { return efficiencyErr () ; }
  StatEntity& operator+= ( const double f ) 
  {
    addFlag ( f ) ; 
    return *this ;
  }
  StatEntity& operator++ ()    { return   (*this)+= 1  ; }
  StatEntity& operator++ (int) { return ++(*this)      ; }
  StatEntity& operator-= ( const double   f ) 
  {
    addFlag ( -f ) ;
    return *this ; 
  }
  StatEntity& operator-- () { return (*this)-=1  ; }
  StatEntity& operator-- (int) { return --(*this) ; }
  StatEntity& operator= ( const double   f ) 
  {
    // reset the statistics 
    reset() ;            
    // use the regular inrement
    return ((*this)+=f); 
  }
  StatEntity& operator+= ( const StatEntity& other ) ;   
public:
  bool operator<( const StatEntity& se ) const ;
  unsigned long addFlag ( const double Flag    ) ;
  void reset() ;
  void setnEntriesBeforeReset ( unsigned long nEntriesBeforeReset );  
  std::string   toString () const;
  std::ostream& print      ( std::ostream& o = std::cout ) const ;
  std::ostream& fillStream ( std::ostream& o ) const { return print ( o ) ; }
private:
  unsigned long                m_se_nEntries          ; 
  double                       m_se_accumulatedFlag   ; 
  double                       m_se_accumulatedFlag2  ;
  double                       m_se_minimalFlag       ;
  double                       m_se_maximalFlag       ;  
  // DR number of calls before reset
  long                         m_se_nEntriesBeforeReset ; 
};
// ============================================================================
StatEntity operator+( const StatEntity& entity , const double      value  ) ;
StatEntity operator+( const double      value  , const StatEntity& entity ) ;
StatEntity operator+( const StatEntity& entity , const StatEntity& value  ) ;
StatEntity operator-( const StatEntity& entity , const double      value  ) ;
std::ostream& operator<<( std::ostream& stream , const StatEntity& entity ) ;
// ============================================================================
namespace Gaudi
{
  namespace Utils
  {
    // ========================================================================
    std::string formatAsTableRow 
    ( const StatEntity&  counter , 
      const bool         flag    , 
      const std::string& format1 = 
      " |%|7d| |%|11.7g| |%|#11.5g| |%|#10.5g| |%|#10.5g| |%|#10.5g| |"        ,
      const std::string& format2 = 
      "*|%|7d| |%|11.5g| |(%|#9.7g| +- %|-#8.6g|)%%|   -----   |   -----   |" );
    // ========================================================================
    std::string formatAsTableRow 
    ( const std::string& name           ,
      const StatEntity&  counter        , 
      const bool         flag    = true , 
      const std::string& format1 = 
      " %|-15.15s|%|17t||%|7d| |%|11.7g| |%|#11.5g| |%|#10.5g| |%|#10.5g| |%|#10.5g| |"       ,
      const std::string& format2 = 
      "*%|-15.15s|%|17t||%|7d| |%|11.5g| |(%|#9.7g| +- %|-#8.6g|)%%|   -----   |   -----   |" );
    // ========================================================================
    std::string formatAsTableRow 
    ( const std::string& name           ,
      const std::string& group          ,
      const StatEntity&  entity         ,
      const bool         flag    = true , 
      const std::string& format1 = 
      " %|15.15s|%|-15.15s|%|32t||%|7d| |%|11.7g| |%|#11.5g| |%|#10.5g| |%|#10.5g| |%|#10.5g| |"         ,
      const std::string& format2 = 
      "*%|15.15s|%|-15.15s|%|32t||%|7d| |%|11.5g| |(%|#9.7g| +- %|-#8.6g|)%%|    -----    |   -----   |" ) ;   
    // ========================================================================
  } // end of namespace Gaudi::Utils
} // end of namespace Gaudi 
// ============================================================================
// The END 
// ============================================================================
#endif // GAUDIKERNEL_STATENTITY_H
// ============================================================================