X-Git-Url: https://git.teslayout.com/public/public/public/?a=blobdiff_plain;f=include%2Fanna%2Fstatistics%2FAccumulator.hpp;h=6c76c781ec777390a178544f6ec2584254d6f10c;hb=5a6cba5fde2b2f538a7515f8293cc0a8d9589dfa;hp=e015e06152f40959f3b1825b694d5b29a9599dc2;hpb=4e12ac57e93c052f716a6305ad8fc099c45899d1;p=anna.git diff --git a/include/anna/statistics/Accumulator.hpp b/include/anna/statistics/Accumulator.hpp index e015e06..6c76c78 100644 --- a/include/anna/statistics/Accumulator.hpp +++ b/include/anna/statistics/Accumulator.hpp @@ -1,37 +1,9 @@ -// ANNA - Anna is Not 'N' Anymore -// -// (c) Copyright 2005-2014 Eduardo Ramos Testillano & Francisco Ruiz Rayo -// -// https://bitbucket.org/testillano/anna -// -// Redistribution and use in source and binary forms, with or without -// modification, are permitted provided that the following conditions -// are met: -// -// * Redistributions of source code must retain the above copyright -// notice, this list of conditions and the following disclaimer. -// * Redistributions in binary form must reproduce the above -// copyright notice, this list of conditions and the following disclaimer -// in the documentation and/or other materials provided with the -// distribution. -// * Neither the name of Google Inc. nor the names of its -// contributors may be used to endorse or promote products derived from -// this software without specific prior written permission. -// -// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -// -// Authors: eduardo.ramos.testillano@gmail.com -// cisco.tierra@gmail.com +// ANNA - Anna is Not Nothingness Anymore // +// // +// (c) Copyright 2005-2015 Eduardo Ramos Testillano & Francisco Ruiz Rayo // +// // +// See project site at http://redmine.teslayout.com/projects/anna-suite // +// See accompanying file LICENSE or copy at http://www.teslayout.com/projects/public/anna.LICENSE // #ifndef anna_statistics_Accumulator_hpp @@ -113,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); /** @@ -142,7 +157,7 @@ public: * * @see process() */ - void reset(void) throw(); + void reset(void) ; /** @@ -152,7 +167,7 @@ public: * * @see process() */ - void reset(const int & conceptId) throw(anna::RuntimeException); + void reset(const int & conceptId) noexcept(false); /** @@ -168,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 * @@ -178,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); /** @@ -192,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); /** @@ -202,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 ; /** @@ -212,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 ; }; }