psprofile.h

Go to the documentation of this file.

/*
 * psprofile.h by Ondrej Hurt
 *
 * Copyright (C) 2001 Atomic Blue (info@planeshift.it, http://www.atomicblue.org)
 *
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation (version 2 of the License)
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 *
 */

#ifndef __PSPROFILE_H__
#define __PSPROFILE_H__

#include <csutil/parray.h>
#include <csutil/csstring.h>
#include <csutil/hash.h>

/****************************************************************************************
* General profilling library
*
* It is used to measure consumption of certain hardware resources (time, bandwidth etc) 
* by different operations. "Operation" is some action that consumes resources.
* Profiler keeps aggregate statistics for each operation. When the operation
* runs more than once, the consumption is added.
*
* Statistics of one operation are kept in psOperProfile.
* All psOperProfiles are kept in some subclass of psOperProfileSet.
* Abstract class psOperProfileSet offers some common actions that can be done with
* the statistics, regardless of their nature. But other actions must be implemented
* in its subclasses. The most important subclass is psNamedProfiles that can be used
* for most purposes.
*****************************************************************************************/

class psOperProfile
{
public:
    psOperProfile(const csString & desc);
    
    void AddConsumption(double cons);
    
    void Reset();
    
    csString Dump(double totalConsumption, const csString & unitName);
    
    double GetConsumption();
    
    static int cmpProfs(const void * a, const void * b);

protected:
    csStringFast<100> desc;         
    double count;          
    double consumption ;   
    double maxCons; // the maximum resource consumption per operation 
                    //     that we witnessed
};

class psOperProfileSet
{
public:
    psOperProfileSet();
    
    void Dump(const csStringFast<50> & unitName, csStringFast<50> & header, csStringFast<50> & list);
    
    void Reset();
    
protected:
    csPDelArray<psOperProfile> profs; 
    csTicks profStart;
};


class psNamedProfiles : public psOperProfileSet
{
public:
    virtual ~psNamedProfiles() { }  

    virtual void AddCons(const csString & operName, csTicks time);
    
    csString Dump(const csString & unitName, const csString & header);
    
    void Reset();

protected:
    csHash<psOperProfile*, csString> namedProfs;
};


class psStopWatch
{
public:
    void Start();
    csTicks Stop();
protected:
    csTicks start;
};

#endif