X-Git-Url: https://git.teslayout.com/public/public/public/?a=blobdiff_plain;f=include%2Fanna%2Fstatistics%2FAccumulator.hpp;h=6c76c781ec777390a178544f6ec2584254d6f10c;hb=5a6cba5fde2b2f538a7515f8293cc0a8d9589dfa;hp=98d4624f589776b889c192aac77ce3d1941a198c;hpb=93366a0bda79e6fd6e7dad6316bfcf8cc82f5731;p=anna.git diff --git a/include/anna/statistics/Accumulator.hpp b/include/anna/statistics/Accumulator.hpp index 98d4624..6c76c78 100644 --- a/include/anna/statistics/Accumulator.hpp +++ b/include/anna/statistics/Accumulator.hpp @@ -85,28 +85,71 @@ typedef std::map ::const_iterator _concept_data_map_iter; * @short Contains statistical sample information */ class Accumulator { + + std::string a_name; + + void initialize(const int & conceptId) ; + _concept_data_t * getConcept(const int & conceptId) const noexcept(false); + // Gets the data structure for a existing concept Id. + // Initializes and returns the new data structure for a new stored concept Id which is valid (exists for the engine). + // Launch exception if concept id is not a valid concept registered at Engine. + + /*mutable */_concept_data_map_t a_concept_data_map; + + std::string floatFormat(const int & numberOfDecimals) const ; + + double getStandardDeviation(const _concept_data_t * conceptData) const noexcept(false); + double getBesselStandardDeviation(const _concept_data_t * conceptData) const noexcept(false); + + public: /** * Constructor. + * + * @param name Accumulator name */ - Accumulator(); + Accumulator(const std::string &name) : a_name(name) {}; /** * Destructor. */ - ~Accumulator(); + ~Accumulator() {;} /** - * Process new value for the sample. + * Sets the accumulator name + * + * @param name Name provided + */ + void setName(const std::string &name) { a_name = name; } + + /** + * Adds a new statistic concept through the accumulator, to ease the concept name creation, + * which will be a string defined by: concept name + ': ' + accumulator name. + * + * @param description Concept description; e.g.: processing time, messages size, etc. + * @param unit Concept unit description + * @param integerNatureSample Most of cases we will measure 'time' with the unit which force integer values + * (is more intuitive 850 msecs than 0,850 secs). Then, it is @em true by default. + * This is useful to advice better representation for some indicators like minimum/maximum + * within integer samples. + * @param conceptNameFormat Format to register the complete concept name. Will be parsed using (in order) the provided + * description, and the accumulator name: ' []' by default. + * + * @return Assigned concept identification number (sequence) + */ + int addConcept(const std::string & description, const std::string & unit, const bool & integerNatureSample = true, const char *conceptNameFormat = "%s [%s]") ; + + /** + * Process new value for the sample regarding a concept identifier previously registered through the engine. * * @param conceptId statistical concept processed * @param value Value for processed item * * @see reset() */ - void process(const int & conceptId, const double & value) throw(anna::RuntimeException); + void process(const int & conceptId, const double & value) noexcept(false); /** @@ -114,7 +157,7 @@ public: * * @see process() */ - void reset(void) throw(); + void reset(void) ; /** @@ -124,7 +167,7 @@ public: * * @see process() */ - void reset(const int & conceptId) throw(anna::RuntimeException); + void reset(const int & conceptId) noexcept(false); /** @@ -140,6 +183,13 @@ public: // Gets + /** + * Gets the accumulator name + * + * @result Accumulator name + */ + const std::string &getName() const { return a_name; } + /** * Gets current sample size for any concept id * @@ -150,7 +200,7 @@ public: * @see getValue() * @see asXML() */ - unsigned long long int sampleSize(const int & conceptId) const throw(anna::RuntimeException); + unsigned long long int sampleSize(const int & conceptId) const noexcept(false); /** @@ -164,7 +214,7 @@ public: * @see sampleSize() * @see asXML() */ - double getValue(const int & conceptId, const Operation::Type & operation) const throw(anna::RuntimeException); + double getValue(const int & conceptId, const Operation::Type & operation) const noexcept(false); /** @@ -174,7 +224,7 @@ public: * * @return String with class content */ - std::string asString(const int & numberOfDecimals = 2) const throw(); + std::string asString(const int & numberOfDecimals = 2) const ; /** @@ -184,22 +234,7 @@ public: * * @return XML with class content */ - anna::xml::Node* asXML(anna::xml::Node* parent, const int & numberOfDecimals = 2) const throw(); - - -private: - - void initialize(const int & conceptId) throw(); - _concept_data_t * getConcept(const int & conceptId) const throw(anna::RuntimeException); - // Return NULL if no data is found for the concept Id - // Launch exception if concept id is not a valid concept registered at Engine - - /*mutable */_concept_data_map_t a_concept_data_map; - - std::string floatFormat(const int & numberOfDecimals) const throw(); - - double getStandardDeviation(const _concept_data_t * conceptData) const throw(anna::RuntimeException); - double getBesselStandardDeviation(const _concept_data_t * conceptData) const throw(anna::RuntimeException); + anna::xml::Node* asXML(anna::xml::Node* parent, const int & numberOfDecimals = 2) const ; }; }