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>
// ============================================================================
// Gaudi
// ============================================================================
#include "GaudiKernel/Kernel.h"
// ============================================================================
class GAUDI_API StatEntity
{
public:
  StatEntity  () { reset() ; }
  /* The full constructor 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 minimum 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 ;
};
// ============================================================================
GAUDI_API StatEntity operator+( const StatEntity& entity , const double      value  ) ;
GAUDI_API StatEntity operator+( const double      value  , const StatEntity& entity ) ;
GAUDI_API StatEntity operator+( const StatEntity& entity , const StatEntity& value  ) ;
GAUDI_API StatEntity operator-( const StatEntity& entity , const double      value  ) ;
GAUDI_API std::ostream& operator<<( std::ostream& stream , const StatEntity& entity ) ;
// ============================================================================
namespace Gaudi
{
  namespace Utils
  {
    // ========================================================================
    GAUDI_API 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|)%%|   -----   |   -----   |" );
    // ========================================================================
    GAUDI_API 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|)%%|   -----   |   -----   |" );
    // ========================================================================
    GAUDI_API 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
// ============================================================================