Bdb packages | Design docs | Source docs | Guidelines | Recent releases
	Search | Site Map .

                 

---

/BdbCond/BdbCondContainerProfile.hh

Go to the documentation of this file.

//-----------------------------------------------------------------------------
//
// File and Version Information:
//      $Id: BdbCondContainerProfile.hh,v 1.2 2002/06/21 18:46:51 ryd Exp $
//
// Description:
//      This class is meant for the profiling of interval containers.
//
// Environment:
//      Software developed for the BaBar Detector at the SLAC B-Factory.
//
// Author List:
//      Igor A. Gaponenko       Original Author
//
// Copyright Information:
//      Copyright (C) 2000      Lawrence Berkeley Laboratory
//
//-----------------------------------------------------------------------------

#ifndef BDBCONDCONTAINERPROFILE_HH
#define BDBCONDCONTAINERPROFILE_HH

// -------------------
// -- BaBar Headers --
// -------------------

#include "BaBar/BaBar.hh"

// ----------------------------
// -- BaBar Database Headers --
// ----------------------------

#include "BdbUtil/Bdb.hh"
 
// ---------------
// -- C Headers --
// ---------------

extern "C" {
#include <stddef.h>
}

// ---------------------------------
// -- Collaborating Class Headers --
// ---------------------------------

#include "BdbCond/BdbIntervalR.hh"
#include "BdbTime/BdbTime.hh"

#include <string>
#include <vector>

// ---------------------
// -- Class Interface --
// ---------------------
 
class BdbCondContainerProfile {

public:

  // Constructor(s)

    BdbCondContainerProfile( );

  // Destructor

    virtual ~BdbCondContainerProfile( );

  // Selectors (state & parameters of the profile)

    inline bool isValid( ) const;

    std::string detectorName ( ) const;
    std::string containerName( ) const;

    BdbTime beginValidityTime( ) const;
    BdbTime endValidityTime  ( ) const;

  // Selectors (results of measurements)

    inline int totalIntervals  ( ) const;
    inline int totalBaseline   ( ) const;
    inline int totalTopmost    ( ) const;
    inline int totalRevised    ( ) const;
    inline int totalNullObjects( ) const;

    inline int maxWidth   ( ) const;
    inline int maxLayers  ( ) const;
    inline int maxVersions( ) const;

    void getWidthHist   ( std::vector<int>& theHist );
    void getLayersHist  ( std::vector<int>& theHist );
    void getVersionsHist( std::vector<int>& theHist );

  // Operations

  // Measure the profile for specified container.

    BdbStatus measure( const char*    theDetectorName,
                       const char*    theContainerName,
                       const BdbTime& theBeginValidityTime = BdbTime::minusInfinity,
                       const BdbTime& theEndValidityTime   = BdbTime::plusInfinity );

  // Print the profile into specified output stream.

    void print( ostream& stream ) const;

  // Helpers (for histograms).

    static int minForBin( int theBin );
    static int maxForBin( int theBin );

private:

  // Helpers.

  // Reset the internal state of the object.

    void reset( );

  // Return the bin number for specified value.

    static int calculateBin( int theValue );

  // Put a value into specified histogram.

    static void addToHist( std::vector<int>& theHistogram, int theValue);

  // Make a copy of a histogram.

    static void copyHist( const std::vector<int>& theInputHist,
                          std::vector<int>&       theOutputHist );

  // Process a sub tree.

    void measureSubTree( const BdbHandle(BdbIntervalR)& theIntervalH,
                         int                            theLayer = 1 );

private:

  // The state of the profile.

    bool _isValid;

  // The parameters of the profile.

    std::string _detectorName;
    std::string _containerName;

    BdbTime _beginValidityTime;
    BdbTime _endValidityTime;

  // The result of the profiling.

    int _totalIntervals;    // Total number of intervals in the container.
    int _totalBaseline;     // Total number of BASELINE intervals.
    int _totalTopmost;      // Total number of TOPMOST intervals.
    int _totalRevised;      // Total number of revised intervals (NOTE: all BASELINE ones are always revised).
    int _totalNullObjects;  // Total number of initervals having NULL object references (to BdbObject).
    int _maxWidth;          // Maximum width of topmost intervals as a number of topmost ones).
    int _maxLayers;         // The maximum number of version layers.
    int _maxVersions;       // The maximum number of versions.

    std::vector<int> _widthHist;
    std::vector<int> _layersHist;
    std::vector<int> _versionsHist;
};

// -----------------------------------
// -- Inline methods implementation --
// -----------------------------------

inline bool
BdbCondContainerProfile::isValid( ) const
{
    return _isValid;
}

inline std::string
BdbCondContainerProfile::detectorName( ) const
{
    return _detectorName;
}

inline std::string
BdbCondContainerProfile::containerName( ) const
{
    return _containerName;
}

inline BdbTime
BdbCondContainerProfile::beginValidityTime( ) const
{
    return _beginValidityTime;
}

inline BdbTime
BdbCondContainerProfile::endValidityTime( ) const
{
    return _endValidityTime;
}

inline int
BdbCondContainerProfile::totalIntervals( ) const
{
    return _totalIntervals;
}

inline int
BdbCondContainerProfile::totalBaseline( ) const
{
    return _totalBaseline;
}
inline int
BdbCondContainerProfile::totalTopmost( ) const
{
    return _totalTopmost;
}

inline int
BdbCondContainerProfile::totalRevised( ) const
{
    return _totalRevised;
}

inline int
BdbCondContainerProfile::totalNullObjects( ) const
{
    return _totalNullObjects;
}

inline int
BdbCondContainerProfile::maxWidth( ) const
{
    return _totalTopmost;

}

inline int
BdbCondContainerProfile::maxLayers( ) const
{
    return _maxLayers;
}

inline int
BdbCondContainerProfile::maxVersions( ) const
{
    return _maxVersions;
}

#endif /* BDBCONDCONTAINERPROFILE_HH */

 

---

BaBar Public Site | SLAC | News | Links | Who's Who | Contact Us

Page Owner: Jacek Becla
Last Update: October 04, 2002