pStatView.cxx

Go to the documentation of this file.

/**
 * PANDA 3D SOFTWARE
 * Copyright (c) Carnegie Mellon University.  All rights reserved.
 *
 * All use of this software is subject to the terms of the revised BSD
 * license.  You should have received a copy of this license along
 * with this source code in a file named "LICENSE."
 *
 * @file pStatView.cxx
 * @author drose
 * @date 2000-07-10
 */
 
#include "pStatView.h"
 
#include "pStatFrameData.h"
#include "pStatCollectorDef.h"
 
#include <algorithm>
#include <vector>
 
/**
 * This class is used within this module only--in fact, within
 * PStatView::set_to_frame() only--to help collect event data out of the
 * PStatFrameData object and boil it down to a list of elapsed times.
 */
class FrameSample {
public:
  void start(double time, FrameSample *started) {
    // Keep track of nested start/stop pairs.  We only consider the outer one.
    if (_started++ > 0) {
      return;
    }
 
    nassertv(!_pushed);
    _net_time -= time;
    push_all(time, started);
    nassertv(_next == nullptr && _prev == nullptr);
    _prev = started->_prev;
    _next = started;
    _prev->_next = this;
    started->_prev = this;
  }
 
  void stop(double time, FrameSample *started) {
    nassertv(_started > 0);
    if (--_started > 0) {
      return;
    }
 
    nassertv(_next != nullptr && _prev != nullptr);
 
    if (_pushed) {
      _prev->_next = _next;
      _next->_prev = _prev;
      _next = _prev = nullptr;
    } else {
      _net_time += time;
      _prev->_next = _next;
      _next->_prev = _prev;
      _next = _prev = nullptr;
      pop_one(time, started);
    }
  }
 
private:
  void push(double time) {
    if (!_pushed) {
      _pushed = true;
      if (_started > 0) {
        _net_time += time;
      }
    }
  }
 
  void pop(double time) {
    if (_pushed) {
      _pushed = false;
      if (_started > 0) {
        _net_time -= time;
      }
    }
  }
 
  void push_all(double time, FrameSample *started) {
    for (FrameSample *sample = started->_next;
         sample != started; sample = sample->_next) {
      sample->push(time);
    }
  }
 
  void pop_one(double time, FrameSample *started) {
    for (FrameSample *sample = started->_prev;
         sample != started; sample = sample->_prev) {
      if (sample->_pushed) {
        sample->pop(time);
        return;
      }
    }
  }
 
public:
  FrameSample *_next = nullptr;
  FrameSample *_prev = nullptr;
  double _net_time = 0.0;
  int _started = 0;
  int _count = 0;
  bool _pushed = false;
  bool _is_new = false;
};
 
/**
 *
 */
PStatView::
PStatView() {
  _constraint = 0;
  _show_level = false;
  _all_collectors_known = false;
  _level_index = 0;
}
 
/**
 *
 */
PStatView::
~PStatView() {
  clear_levels();
}
 
/**
 * Changes the focus of the View.  By default, the View reports the entire
 * time for the frame, and all of the Collectors that are directly parented to
 * "Frame".  By constraining the view to a particular collector, you cause the
 * View to zoom in on that collector's data, reporting only the collector and
 * its immediate parents.
 *
 * When you constrain the view, you may also specify whether the view should
 * show time data or level data for the indicated collector.  If level data,
 * it reports the levels for the collector, and all of its children;
 * otherwise, it collects the elapsed time.
 *
 * Changing the constraint causes the current frame's data to become
 * invalidated; you must then call set_to_frame() again to get any useful data
 * out.
 */
void PStatView::
constrain(int collector, bool show_level) {
  _constraint = collector;
  _show_level = show_level;
  clear_levels();
}
 
/**
 * Restores the view to the full frame.  This is equivalent to calling
 * constrain(0).
 */
void PStatView::
unconstrain() {
  constrain(0, false);
}
 
/**
 *
 */
void PStatView::
set_thread_data(const PStatThreadData *thread_data) {
  _thread_data = thread_data;
  _client_data = thread_data->get_client_data();
  clear_levels();
  _all_collectors_known = false;
}
 
/**
 * Supplies the View with the data for the current frame.  This causes the
 * View to update all of its internal data to reflect the frame's data,
 * subject to the current constraint.
 *
 * It is possible that calling this will increase the total number of reported
 * levels (for instance, if this frame introduced a new collector that hadn't
 * been active previously).  In this case, the caller must update its display
 * or whatever to account for the new level.
 */
void PStatView::
set_to_frame(const PStatFrameData &frame_data) {
  nassertv(!_thread_data.is_null());
  nassertv(!_client_data.is_null());
 
  if (_show_level) {
    update_level_data(frame_data);
  } else {
    update_time_data(frame_data);
  }
}
 
 
/**
 * After a call to set_to_frame(), this returns true if all collectors in the
 * FrameData are known by the PStatsData object, or false if some are still
 * unknown (even those that do not appear in the view).
 */
bool PStatView::
all_collectors_known() const {
  return _all_collectors_known;
}
 
/**
 * Returns the total value accounted for by the frame (or by whatever
 * Collector we are constrained to).  This is the sum of all of the individual
 * levels' get_net_value() value.
 */
double PStatView::
get_net_value() const {
  double net = 0.0;
  Levels::const_iterator li;
  for (li = _levels.begin(); li != _levels.end(); ++li) {
    net += (*li).second->_value_alone;
  }
 
  return net;
}
 
/**
 * Returns a pointer to the level that corresponds to the Collector we've
 * constrained to.  This is the top of a graph of levels; typically the next
 * level down--the children of this level--will be the levels you want to
 * display to the user.
 */
const PStatViewLevel *PStatView::
get_top_level() {
  return get_level(_constraint);
}
 
/**
 * Returns true if there is a level defined for the particular collector,
 * false otherwise.
 */
bool PStatView::
has_level(int collector) const {
  Levels::const_iterator li;
  li = _levels.find(collector);
  return (li != _levels.end());
}
 
/**
 * Returns a pointer to the level that corresponds to the indicated Collector.
 * If there is no such level in the view, one will be created--use with
 * caution.  Check has_level() first if you don't want this behavior.
 */
PStatViewLevel *PStatView::
get_level(int collector) {
  Levels::const_iterator li;
  li = _levels.find(collector);
  if (li != _levels.end()) {
    return (*li).second;
  }
 
  PStatViewLevel *level = new PStatViewLevel;
  level->_collector = collector;
  level->_parent = nullptr;
  _levels[collector] = level;
 
  reset_level(level);
  return level;
}
 
/**
 * The implementation of set_to_frame() for views that show elapsed time.
 */
void PStatView::
update_time_data(const PStatFrameData &frame_data) {
  int num_events = frame_data.get_num_events();
  int num_collectors = _client_data->get_num_collectors();
 
  typedef std::vector<FrameSample> Samples;
  Samples samples(num_collectors);
 
  // Keep a linked list of started samples.
  FrameSample started;
  started._next = &started;
  started._prev = &started;
 
  _all_collectors_known = true;
 
  int new_collectors = 0;
  int i;
  for (i = 0; i < num_events; i++) {
    int collector_index = frame_data.get_time_collector(i);
    bool is_start = frame_data.is_start(i);
 
    if (!_client_data->has_collector(collector_index)) {
      _all_collectors_known = false;
 
    } else {
      nassertv(collector_index >= 0 && collector_index < num_collectors);
 
      if (_client_data->get_child_distance(_constraint, collector_index) >= 0) {
        // Here's a data point we care about: anything at constraint level or
        // below.
        if (is_start) {
          samples[collector_index].start(frame_data.get_time(i), &started);
          samples[collector_index]._count++;
        } else {
          // A "stop" in the middle of a frame implies a "start" since time
          // 0 (that is, since the first data point in the frame).
          if (samples[collector_index]._started == 0) {
            samples[collector_index].start(frame_data.get_time(0), &started);
          }
          samples[collector_index].stop(frame_data.get_time(i), &started);
        }
 
        if (!samples[collector_index]._is_new) {
          samples[collector_index]._is_new = true;
          ++new_collectors;
        }
      }
    }
  }
 
  // Make sure everything is stopped.
  Samples::iterator si;
  for (i = 0, si = samples.begin(); si != samples.end(); ++i, ++si) {
    if ((*si)._started > 0) {
      (*si).stop(frame_data.get_end(), &started);
    }
  }
 
  nassertv(started._next == &started && started._prev == &started);
 
  bool any_new_levels = false;
 
  // Now match these samples we got up with those we already had in the
  // levels.
  Levels::iterator li, lnext;
  li = _levels.begin();
  while (li != _levels.end()) {
    // Be careful while traversing a container and calling functions that
    // could modify that container.
    lnext = li;
    ++lnext;
 
    PStatViewLevel *level = (*li).second;
    if (reset_level(level)) {
      any_new_levels = true;
    }
 
    int collector_index = level->_collector;
    if (samples[collector_index]._is_new) {
      level->_value_alone = samples[collector_index]._net_time;
      level->_count = samples[collector_index]._count;
      samples[collector_index]._is_new = false;
      --new_collectors;
    }
 
    li = lnext;
  }
 
  // Finally, any samples left over in the got_samples set are new collectors
  // that we need to add to the Levels list.
  if (new_collectors > 0) {
    any_new_levels = true;
 
    for (int collector_index = 0; collector_index < num_collectors; ++collector_index) {
      if (samples[collector_index]._is_new) {
        PStatViewLevel *level = get_level(collector_index);
        level->_value_alone = samples[collector_index]._net_time;
        level->_count = samples[collector_index]._count;
      }
    }
  }
 
  if (any_new_levels) {
    _level_index++;
  }
}
 
/**
 * The implementation of set_to_frame() for views that show level values.
 */
void PStatView::
update_level_data(const PStatFrameData &frame_data) {
  _all_collectors_known = true;
 
 
  // This tracks the set of level values we got.
  typedef pmap<int, double> GotValues;
  GotValues net_values;
 
  int i;
  int num_levels = frame_data.get_num_levels();
  for (i = 0; i < num_levels; i++) {
    int collector_index = frame_data.get_level_collector(i);
    double value = frame_data.get_level(i);
 
    if (!_client_data->has_collector(collector_index)) {
      _all_collectors_known = false;
 
    } else {
      if (_client_data->get_child_distance(_constraint, collector_index) >= 0) {
        net_values[collector_index] = value;
      }
    }
  }
 
  // Now that we've counted up the net level for each collector, compute the
  // level for each collector alone by subtracting out each child from its
  // parents.  If a parent has no data, nothing is subtracted.
  GotValues alone_values = net_values;
 
  GotValues::iterator gi;
  for (gi = net_values.begin(); gi != net_values.end(); ++gi) {
    int collector_index = (*gi).first;
    double value = (*gi).second;
 
    // Walk up to the top, but stop when we find a parent with actual data.
    while (collector_index != 0 && collector_index != _constraint) {
      const PStatCollectorDef &def =
        _client_data->get_collector_def(collector_index);
      int parent_index = def._parent_index;
      GotValues::iterator pi = alone_values.find(parent_index);
      if (pi != alone_values.end()) {
        // The parent has data; subtract it.
        (*pi).second -= value;
        break;
      }
      collector_index = parent_index;
    }
  }
 
 
  bool any_new_levels = false;
 
  // Now match these samples we got up with those we already had in the
  // levels.
  Levels::iterator li, lnext;
  li = _levels.begin();
  while (li != _levels.end()) {
    // Be careful while traversing a container and calling functions that
    // could modify that container.
    lnext = li;
    ++lnext;
 
    PStatViewLevel *level = (*li).second;
    if (reset_level(level)) {
      any_new_levels = true;
    }
 
    int collector_index = level->_collector;
    GotValues::iterator gi;
    gi = alone_values.find(collector_index);
    if (gi != alone_values.end()) {
      level->_value_alone = (*gi).second;
      alone_values.erase(gi);
    }
 
    li = lnext;
  }
 
  // Finally, any values left over in the alone_values set are new collectors
  // that we need to add to the Levels list.
  if (!alone_values.empty()) {
    any_new_levels = true;
 
    GotValues::const_iterator gi;
    for (gi = alone_values.begin(); gi != alone_values.end(); ++gi) {
      int collector_index = (*gi).first;
      PStatViewLevel *level = get_level(collector_index);
      level->_value_alone = (*gi).second;
    }
  }
 
  if (any_new_levels) {
    _level_index++;
  }
}
 
/**
 * Resets all the levels that have been defined so far.
 */
void PStatView::
clear_levels() {
  Levels::iterator li;
  for (li = _levels.begin(); li != _levels.end(); ++li) {
    delete (*li).second;
  }
  _levels.clear();
}
 
/**
 * Resets the total value of the Level to zero, and also makes sure it is
 * parented to the right Level corresponding to its Collector's parent.  Since
 * the client might change its mind from time to time about who the Collector
 * is parented to, we have to update this dynamically.
 *
 * Returns true if any change was made to the level's hierarchy, false
 * otherwise.
 */
bool PStatView::
reset_level(PStatViewLevel *level) {
  bool any_changed = false;
  level->_value_alone = 0.0;
  level->_count = 0;
 
  if (level->_collector == _constraint) {
    return false;
  }
 
  if (_client_data->has_collector(level->_collector)) {
    int parent_index =
      _client_data->get_collector_def(level->_collector)._parent_index;
 
    if (level->_parent == nullptr) {
      // This level didn't know its parent before, but now it does.
      PStatViewLevel *parent_level = get_level(parent_index);
      nassertr(parent_level != level, true);
 
      level->_parent = parent_level;
      parent_level->_children.push_back(level);
      parent_level->sort_children(_client_data);
      any_changed = true;
 
    } else if (level->_parent->_collector != parent_index) {
      // This level knew about its parent, but now it's something different.
      PStatViewLevel *old_parent_level = level->_parent;
      nassertr(old_parent_level != level, true);
 
      if (parent_index != 0) {
        PStatViewLevel *new_parent_level = get_level(parent_index);
        nassertr(new_parent_level != level, true);
        level->_parent = new_parent_level;
        new_parent_level->_children.push_back(level);
        new_parent_level->sort_children(_client_data);
      } else {
        level->_parent = nullptr;
      }
 
      PStatViewLevel::Children::iterator ci =
        find(old_parent_level->_children.begin(),
             old_parent_level->_children.end(),
             level);
 
      nassertr(ci != old_parent_level->_children.end(), true);
      old_parent_level->_children.erase(ci);
      any_changed = true;
    }
  }
 
  return any_changed;
}