stop-watch.cpp

 
// Copyright (c) 2010-2013 Tommaso Urli (tommaso.urli@uniud.it; University of
// Udine)
//
// Permission is hereby granted, free of charge, to any person obtaining
// a copy of this software and associated documentation files (the
// "Software"), to deal in the Software without restriction, including
// without limitation the rights to use, copy, modify, merge, publish,
// distribute, sublicense, and/or sell copies of the Software, and to
// permit persons to whom the Software is furnished to do so, subject to
// the following conditions:
//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
#ifndef WIN32
#include <sys/time.h>
#else
#include <Windows.h>
 
#include <iomanip>
#endif
 
#include <iomanip>  // std::setprecision
 
#include "crocoddyl/core/utils/stop-watch.hpp"
 
using std::map;
using std::ostringstream;
using std::string;
 
namespace crocoddyl {
 
Stopwatch& getProfiler() {
  static Stopwatch s(REAL_TIME);  // alternatives are CPU_TIME and REAL_TIME
  return s;
}
 
Stopwatch::Stopwatch(StopwatchMode _mode)
    : active(true), mode(_mode), profiler_active(false) {
  records_of = new map<string, PerformanceData>();
}
 
Stopwatch::~Stopwatch() { delete records_of; }
 
void Stopwatch::enable_profiler() { profiler_active = true; }
 
void Stopwatch::disable_profiler() { profiler_active = false; }
 
void Stopwatch::set_mode(StopwatchMode new_mode) { mode = new_mode; }
 
bool Stopwatch::performance_exists(string perf_name) {
  return (records_of->find(perf_name) != records_of->end());
}
 
long double Stopwatch::take_time() {
  if (mode == CPU_TIME) {
    // Use ctime
    return (long double)clock();
  } else if (mode == REAL_TIME) {
    // Query operating system
 
#ifdef WIN32
    /*  In case of usage under Windows */
    FILETIME ft;
    LARGE_INTEGER intervals;
 
    // Get the amount of 100 nanoseconds intervals elapsed since January 1, 1601
    // (UTC)
    GetSystemTimeAsFileTime(&ft);
    intervals.LowPart = ft.dwLowDateTime;
    intervals.HighPart = ft.dwHighDateTime;
 
    long double measure = intervals.QuadPart;
    measure -= 116444736000000000.0;  // Convert to UNIX epoch time
    measure /= 10000000.0;            // Convert to seconds
 
    return measure;
#else
    /* Linux, MacOS, ... */
    struct timeval tv;
    gettimeofday(&tv, NULL);
 
    long double measure = tv.tv_usec;
    measure /= 1000000.0;               // Convert to seconds
    measure += (long double)tv.tv_sec;  // Add seconds part
    return measure;
#endif
 
  } else {
    // If mode == NONE, clock has not been initialized, then throw exception
    throw StopwatchException("Clock not initialized to a time taking mode!");
  }
}
 
Stopwatch::PerformanceData& Stopwatch::get_or_create_perf(
    const string& perf_name) {
  const auto it = records_of->insert(make_pair(perf_name, PerformanceData()));
  return it.first->second;
}
 
void Stopwatch::start(const string& perf_name) {
  if (!active) return;
 
  PerformanceData& perf_info = get_or_create_perf(perf_name);
 
  // Take ctime
  perf_info.clock_start = take_time();
 
  // If this is a new start (i.e. not a restart)
  //  if (!perf_info.paused)
  //    perf_info.last_time = 0;
 
  perf_info.paused = false;
}
 
void Stopwatch::stop(const string& perf_name) {
  if (!active) return;
 
  long double clock_end = take_time();
 
  // Try to recover performance data
  if (!performance_exists(perf_name))
    throw StopwatchException("Performance not initialized.");
 
  PerformanceData& perf_info = records_of->find(perf_name)->second;
 
  stop_perf(perf_info, clock_end);
}
 
void Stopwatch::stop_perf(PerformanceData& perf_info, long double clock_end) {
  // check whether the performance has been reset
  if (perf_info.clock_start == 0) return;
 
  perf_info.stops++;
  long double lapse = clock_end - perf_info.clock_start;
 
  if (mode == CPU_TIME) lapse /= (double)CLOCKS_PER_SEC;
 
  // Update last time
  perf_info.last_time = lapse;
 
  // Update min/max time
  if (lapse >= perf_info.max_time)
    perf_info.max_time = lapse;
  else if (lapse <= perf_info.min_time)
    perf_info.min_time = lapse;
 
  // Update total time
  perf_info.total_time += lapse;
}
 
void Stopwatch::pause(const string& perf_name) {
  if (!active) return;
 
  long double clock_end = (long double)clock();
 
  // Try to recover performance data
  if (!performance_exists(perf_name))
    throw StopwatchException("Performance not initialized.");
 
  PerformanceData& perf_info = records_of->find(perf_name)->second;
 
  // check whether the performance has been reset
  if (perf_info.clock_start == 0) return;
 
  long double lapse = clock_end - perf_info.clock_start;
 
  // Update total time
  perf_info.last_time += lapse;
  perf_info.total_time += lapse;
}
 
void Stopwatch::reset_all() {
  if (!active) return;
 
  map<string, PerformanceData>::iterator it;
 
  for (it = records_of->begin(); it != records_of->end(); ++it) {
    reset(it->first);
  }
}
 
void Stopwatch::report_all(int precision, std::ostream& output) {
  if (!active) return;
 
  output << "\n"
         << std::setw(STOP_WATCH_MAX_NAME_LENGTH) << std::left
         << "*** PROFILING RESULTS [ms] ";
  output << std::setw(STOP_WATCH_TIME_WIDTH) << "min"
         << " ";
  output << std::setw(STOP_WATCH_TIME_WIDTH) << "avg"
         << " ";
  output << std::setw(STOP_WATCH_TIME_WIDTH) << "max"
         << " ";
  output << std::setw(STOP_WATCH_TIME_WIDTH) << "lastTime"
         << " ";
  output << std::setw(STOP_WATCH_TIME_WIDTH) << "nSamples"
         << " ";
  output << std::setw(STOP_WATCH_TIME_WIDTH) << "totalTime"
         << " ***\n";
  map<string, PerformanceData>::iterator it;
  for (it = records_of->begin(); it != records_of->end(); ++it) {
    if (it->second.stops > 0) report(it->first, precision, output);
  }
}
 
void Stopwatch::reset(const string& perf_name) {
  if (!active) return;
 
  // Try to recover performance data
  if (!performance_exists(perf_name))
    throw StopwatchException("Performance not initialized.");
 
  PerformanceData& perf_info = records_of->find(perf_name)->second;
 
  perf_info.clock_start = 0;
  perf_info.total_time = 0;
  perf_info.min_time = 0;
  perf_info.max_time = 0;
  perf_info.last_time = 0;
  perf_info.paused = false;
  perf_info.stops = 0;
}
 
void Stopwatch::turn_on() {
  std::cout << "Stopwatch active." << std::endl;
  active = true;
}
 
void Stopwatch::turn_off() {
  std::cout << "Stopwatch inactive." << std::endl;
  active = false;
}
 
void Stopwatch::report(const string& perf_name, int precision,
                       std::ostream& output) {
  if (!active) return;
 
  // Try to recover performance data
  if (!performance_exists(perf_name))
    throw StopwatchException("Performance not initialized.");
 
  PerformanceData& perf_info = records_of->find(perf_name)->second;
 
  output << std::setw(STOP_WATCH_MAX_NAME_LENGTH) << std::left << perf_name;
  output << std::fixed << std::setprecision(precision)
         << std::setw(STOP_WATCH_TIME_WIDTH) << (perf_info.min_time * 1e3)
         << " ";
  output << std::fixed << std::setprecision(precision)
         << std::setw(STOP_WATCH_TIME_WIDTH)
         << (perf_info.total_time * 1e3 / (long double)perf_info.stops) << " ";
  output << std::fixed << std::setprecision(precision)
         << std::setw(STOP_WATCH_TIME_WIDTH) << (perf_info.max_time * 1e3)
         << " ";
  output << std::fixed << std::setprecision(precision)
         << std::setw(STOP_WATCH_TIME_WIDTH) << (perf_info.last_time * 1e3)
         << " ";
  output << std::fixed << std::setprecision(precision)
         << std::setw(STOP_WATCH_TIME_WIDTH) << perf_info.stops << " ";
  output << std::fixed << std::setprecision(precision)
         << std::setw(STOP_WATCH_TIME_WIDTH) << perf_info.total_time * 1e3
         << std::endl;
}
 
long double Stopwatch::get_time_so_far(const string& perf_name) {
  // Try to recover performance data
  if (!performance_exists(perf_name))
    throw StopwatchException("Performance not initialized.");
 
  long double lapse =
      (take_time() - (records_of->find(perf_name)->second).clock_start);
 
  if (mode == CPU_TIME) lapse /= (double)CLOCKS_PER_SEC;
 
  return lapse;
}
 
long double Stopwatch::get_total_time(const string& perf_name) {
  // Try to recover performance data
  if (!performance_exists(perf_name))
    throw StopwatchException("Performance not initialized.");
 
  PerformanceData& perf_info = records_of->find(perf_name)->second;
 
  return perf_info.total_time;
}
 
long double Stopwatch::get_average_time(const string& perf_name) {
  // Try to recover performance data
  if (!performance_exists(perf_name))
    throw StopwatchException("Performance not initialized.");
 
  PerformanceData& perf_info = records_of->find(perf_name)->second;
 
  return (perf_info.total_time / (long double)perf_info.stops);
}
 
long double Stopwatch::get_min_time(const string& perf_name) {
  // Try to recover performance data
  if (!performance_exists(perf_name))
    throw StopwatchException("Performance not initialized.");
 
  PerformanceData& perf_info = records_of->find(perf_name)->second;
 
  return perf_info.min_time;
}
 
long double Stopwatch::get_max_time(const string& perf_name) {
  // Try to recover performance data
  if (!performance_exists(perf_name))
    throw StopwatchException("Performance not initialized.");
 
  PerformanceData& perf_info = records_of->find(perf_name)->second;
 
  return perf_info.max_time;
}
 
long double Stopwatch::get_last_time(const string& perf_name) {
  // Try to recover performance data
  if (!performance_exists(perf_name))
    throw StopwatchException("Performance not initialized.");
 
  PerformanceData& perf_info = records_of->find(perf_name)->second;
 
  return perf_info.last_time;
}
 
Stopwatch::Watcher Stopwatch::watcher(const string& perf_name) {
  if (!active) return Watcher(*this, perf_name, nullptr);
 
  const auto it = records_of->insert(make_pair(perf_name, PerformanceData()));
 
  PerformanceData* perf_info = &(it.first->second);
 
  return Watcher(*this, perf_name, perf_info);
}
 
void Stopwatch::Watcher::_start() {
  if (!w.profiler_active) return;
 
  if (p == nullptr) {
    p = &w.get_or_create_perf(n);
  }
 
  p->clock_start = w.take_time();
  p->paused = false;
}
 
void Stopwatch::Watcher::_stop() {
  if (!w.profiler_active || (p == nullptr)) return;
 
  long double clock_end = w.take_time();
  w.stop_perf(*p, clock_end);
}
 
}  // end namespace crocoddyl