blob: 722c92ae355ba12abe817c7162ef9c62fb6e149a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
//=============================================================================
/**
* @file Basic_Stats.h
*
* $Id$
*
* @author Carlos O'Ryan <coryan@uci.edu>
*/
//=============================================================================
#ifndef ACE_BASIC_STATS_H
#define ACE_BASIC_STATS_H
#include "ace/pre.h"
#include "ace/config-all.h"
#include "ace/Basic_Types.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
/// Collect basic stats about a series of samples
/**
* Compute the average and standard deviation (aka jitter) for an
* arbitrary number of samples, using constant space.
* Normally used for latency statistics.
*/
class ACE_Export ACE_Basic_Stats
{
public:
/// Constructor
/**
* The number of samples is pre-allocated, and cannot changes once
* the class is initialized.
*/
ACE_Basic_Stats (void);
/// The number of samples received so far
ACE_UINT32 samples_count (void) const;
/// Record one sample.
void sample (ACE_UINT64 value);
/// Update the values to reflect the stats in @param rhs
void accumulate (const ACE_Basic_Stats &rhs);
/// Dump all the samples
/**
* Prints out the results, using @param msg as a prefix for each
* message and scaling all the numbers by @param scale_factor.
* The latter is useful because high resolution timer samples are
* acquired in clock ticks, but often presented in microseconds.
*/
void dump_results (const ACE_TCHAR *msg,
ACE_UINT32 scale_factor) const;
private:
/// The number of samples
ACE_UINT32 samples_count_;
/// The minimum value
ACE_UINT64 min_;
/// The number of the sample that had the minimum value
ACE_UINT32 min_at_;
/// The maximum value
ACE_UINT64 max_;
/// The number of the sample that had the maximum value
ACE_UINT32 max_at_;
/// The sum of all the values
ACE_UINT64 sum_;
/// The sum of the square of all the values
ACE_UINT64 sum2_;
};
#if defined (__ACE_INLINE__)
#include "ace/Basic_Stats.inl"
#endif /* __ACE_INLINE__ */
#include "ace/post.h"
#endif /* ACE_BASIC_STATS_H */
|