#pragma once #include "EmberDefines.h" /// /// Timing and CriticalSection classes. /// namespace EmberNs { /// /// Since the algorithm is so computationally intensive, timing and benchmarking are an integral portion /// of both the development process and the execution results. This class provides an easy way to time /// things by simply calling its Tic() and Toc() member functions. It also assists with formatting the /// elapsed time as a string. /// class EMBER_API Timing { public: /// /// Constructor that takes an optional precision argument which specifies how many digits after the decimal place should be printed for seconds. /// As a convenience, the Tic() function is called automatically. /// /// The precision of the seconds field of the elapsed time. Default: 2. Timing(int precision = 2) noexcept { m_Precision = precision; Init(); Tic(); } /// /// Set the begin time. /// /// The begin time cast to a double double Tic() noexcept { m_BeginTime = NowMsD(); return BeginTime(); } /// /// Set the end time and optionally output a string showing the elapsed time. /// /// The string to output. Default: nullptr. /// If true, output the string verbatim, else output the text " processing time: " in between str and the formatted time. /// The elapsed time in milliseconds as a double double Toc(const char* str = nullptr, bool fullString = false) { m_EndTime = NowMsD(); const auto ms = ElapsedTime(); if (str) { cout << string(str) << (fullString ? "" : " processing time: ") << Format(ms) << "\n"; } return ms; } /// /// Return the begin time as a double. /// /// double BeginTime() const noexcept { return static_cast(m_BeginTime.time_since_epoch().count()); } /// /// Return the end time as a double. /// /// double EndTime() const noexcept { return static_cast(m_EndTime.time_since_epoch().count()); } /// /// Return the elapsed time in milliseconds. /// /// The elapsed time in milliseconds as a double double ElapsedTime() const noexcept { return (m_EndTime - m_BeginTime).count(); } /// /// Formats a specified milliseconds value as a string. /// This uses some intelligence to determine what to return depending on how much time has elapsed. /// Days, hours and minutes are only included if 1 or more of them has elapsed. Seconds are always /// included as a decimal value with the precision the user specified in the constructor. /// /// The time in milliseconds to format /// The formatted string string Format(double ms) const { stringstream ss; double x = ms / 1000; const auto secs = fmod(x, 60); x /= 60; const auto mins = fmod(x, 60); x /= 60; const auto hours = fmod(x, 24); x /= 24; const auto days = x; if (days >= 1) ss << static_cast(days) << "d "; if (hours >= 1) ss << static_cast(hours) << "h "; if (mins >= 1) ss << static_cast(mins) << "m "; ss << std::fixed << std::setprecision(m_Precision) << secs << "s"; return ss.str(); } /// /// Return the number of cores in the system. /// /// The number of cores in the system static uint ProcessorCount() { Init(); return m_ProcessorCount; } private: /// /// Query and store the performance info of the system. /// Since it will never change it only needs to be queried once. /// This is achieved by keeping static state and performance variables. /// static void Init() noexcept { if (!m_TimingInit) { m_ProcessorCount = thread::hardware_concurrency(); m_TimingInit = true; } } int m_Precision;//How many digits after the decimal place to print for seconds. DoubleMsTimePoint m_BeginTime;//The start of the timing, set with Tic(). DoubleMsTimePoint m_EndTime;//The end of the timing, set with Toc(). static bool m_TimingInit;//Whether the performance info has bee queried. static uint m_ProcessorCount;//The number of cores on the system, set in Init(). }; }