src/mc/explo/udpor/EventSet.cpp

   1 /* Copyright (c) 2008-2023. The SimGrid Team. All rights reserved.          */
   2
   3 /* This program is free software; you can redistribute it and/or modify it
   4  * under the terms of the license (GNU LGPL) which comes with this package. */
   5
   6 #include "src/mc/explo/udpor/EventSet.hpp"
   7 #include "src/mc/explo/udpor/Configuration.hpp"
   8 #include "src/mc/explo/udpor/History.hpp"
   9 #include "src/mc/explo/udpor/UnfoldingEvent.hpp"
  10 #include "src/xbt/utils/iter/variable_for_loop.hpp"
  11
  12 #include <stack>
  13 #include <vector>
  14
  15 namespace simgrid::mc::udpor {
  16
  17 EventSet::EventSet(Configuration&& config) : EventSet(config.get_events()) {}
  18
  19 void EventSet::remove(const UnfoldingEvent* e)
  20 {
  21   this->events_.erase(e);
  22 }
  23
  24 void EventSet::subtract(const EventSet& other)
  25 {
  26   this->events_ = std::move(subtracting(other).events_);
  27 }
  28
  29 void EventSet::subtract(const Configuration& config)
  30 {
  31   subtract(config.get_events());
  32 }
  33
  34 EventSet EventSet::subtracting(const EventSet& other) const
  35 {
  36   std::unordered_set<const UnfoldingEvent*> result = this->events_;
  37
  38   for (const UnfoldingEvent* e : other.events_)
  39     result.erase(e);
  40
  41   return EventSet(std::move(result));
  42 }
  43
  44 EventSet EventSet::subtracting(const Configuration& config) const
  45 {
  46   return subtracting(config.get_events());
  47 }
  48
  49 EventSet EventSet::subtracting(const UnfoldingEvent* e) const
  50 {
  51   auto result = this->events_;
  52   result.erase(e);
  53   return EventSet(std::move(result));
  54 }
  55
  56 void EventSet::insert(const UnfoldingEvent* e)
  57 {
  58   this->events_.insert(e);
  59 }
  60
  61 void EventSet::form_union(const EventSet& other)
  62 {
  63   this->events_ = std::move(make_union(other).events_);
  64 }
  65
  66 void EventSet::form_union(const Configuration& config)
  67 {
  68   form_union(config.get_events());
  69 }
  70
  71 EventSet EventSet::make_union(const UnfoldingEvent* e) const
  72 {
  73   auto result = this->events_;
  74   result.insert(e);
  75   return EventSet(std::move(result));
  76 }
  77
  78 EventSet EventSet::make_union(const EventSet& other) const
  79 {
  80   std::unordered_set<const UnfoldingEvent*> result = this->events_;
  81
  82   for (const UnfoldingEvent* e : other.events_)
  83     result.insert(e);
  84
  85   return EventSet(std::move(result));
  86 }
  87
  88 EventSet EventSet::make_union(const Configuration& config) const
  89 {
  90   return make_union(config.get_events());
  91 }
  92
  93 EventSet EventSet::get_local_config() const
  94 {
  95   return History(*this).get_all_events();
  96 }
  97
  98 size_t EventSet::size() const
  99 {
 100   return this->events_.size();
 101 }
 102
 103 bool EventSet::empty() const
 104 {
 105   return this->events_.empty();
 106 }
 107
 108 bool EventSet::contains(const UnfoldingEvent* e) const
 109 {
 110   return this->events_.find(e) != this->events_.end();
 111 }
 112
 113 bool EventSet::is_subset_of(const EventSet& other) const
 114 {
 115   // If there is some element not contained in `other`, then
 116   // the set difference will contain that element and the
 117   // result won't be empty
 118   return subtracting(other).empty();
 119 }
 120
 121 bool EventSet::is_valid_configuration() const
 122 {
 123   /// @invariant: A collection of events `E` is a configuration
 124   /// if and only if following while following the history of
 125   /// each event `e` of `E` you remain in `E`. In other words, you
 126   /// only see events from set `E`
 127   ///
 128   /// The simple proof is based on the definition of a configuration
 129   /// which requires that all events have their history contained
 130   /// in the set
 131   const History history(*this);
 132   return contains(history) && is_conflict_free();
 133 }
 134
 135 bool EventSet::contains(const History& history) const
 136 {
 137   return std::all_of(history.begin(), history.end(), [=](const UnfoldingEvent* e) { return this->contains(e); });
 138 }
 139
 140 bool EventSet::intersects(const History& history) const
 141 {
 142   return std::any_of(history.begin(), history.end(), [=](const UnfoldingEvent* e) { return this->contains(e); });
 143 }
 144
 145 bool EventSet::is_maximal() const
 146 {
 147   // A set of events is maximal if no event from
 148   // the original set is ruled out when traversing
 149   // the history of the events
 150   const History history(*this);
 151   return *this == history.get_all_maximal_events();
 152 }
 153
 154 bool EventSet::is_conflict_free() const
 155 {
 156   const auto begin = simgrid::xbt::variable_for_loop<const EventSet>{{*this}, {*this}};
 157   const auto end   = simgrid::xbt::variable_for_loop<const EventSet>();
 158   return std::none_of(begin, end, [=](const auto event_pair) {
 159     const UnfoldingEvent* e1 = *event_pair[0];
 160     const UnfoldingEvent* e2 = *event_pair[1];
 161     return e1->conflicts_with(e2);
 162   });
 163 }
 164
 165 std::vector<const UnfoldingEvent*> EventSet::get_topological_ordering() const
 166 {
 167   // This is essentially an implementation of detecting cycles
 168   // in a graph with coloring, except it makes a topological
 169   // ordering out of it
 170   if (empty()) {
 171     return std::vector<const UnfoldingEvent*>();
 172   }
 173
 174   std::stack<const UnfoldingEvent*> event_stack;
 175   std::vector<const UnfoldingEvent*> topological_ordering;
 176   EventSet unknown_events = *this;
 177   EventSet temporarily_marked_events;
 178   EventSet permanently_marked_events;
 179
 180   while (not unknown_events.empty()) {
 181     EventSet discovered_events;
 182     event_stack.push(*unknown_events.begin());
 183
 184     while (not event_stack.empty()) {
 185       const UnfoldingEvent* evt = event_stack.top();
 186       discovered_events.insert(evt);
 187
 188       if (not temporarily_marked_events.contains(evt)) {
 189         // If this event hasn't yet been marked, do
 190         // so now so that if we both see it
 191         // again in a child we can detect a cycle
 192         temporarily_marked_events.insert(evt);
 193
 194         EventSet immediate_causes = evt->get_immediate_causes();
 195         if (!immediate_causes.empty() && immediate_causes.is_subset_of(temporarily_marked_events)) {
 196           throw std::invalid_argument("Attempted to perform a topological sort on a configuration "
 197                                       "whose contents contain a cycle. The configuration (and the graph "
 198                                       "connecting all of the events) is an invalid event structure");
 199         }
 200         immediate_causes.subtract(discovered_events);
 201         immediate_causes.subtract(permanently_marked_events);
 202         std::for_each(immediate_causes.begin(), immediate_causes.end(),
 203                       [&event_stack](const UnfoldingEvent* cause) { event_stack.push(cause); });
 204       } else {
 205         unknown_events.remove(evt);
 206         temporarily_marked_events.remove(evt);
 207         permanently_marked_events.insert(evt);
 208
 209         // In moving this event to the end of the list,
 210         // we are saying this events "happens before" other
 211         // events that are added later.
 212         if (this->contains(evt)) {
 213           topological_ordering.push_back(evt);
 214         }
 215
 216         // Only now do we remove the event, i.e. once
 217         // we've processed the same event twice
 218         event_stack.pop();
 219       }
 220     }
 221   }
 222   return topological_ordering;
 223 }
 224
 225 std::vector<const UnfoldingEvent*> EventSet::get_topological_ordering_of_reverse_graph() const
 226 {
 227   // The implementation exploits the property that
 228   // a topological sorting S^R of the reverse graph G^R
 229   // of some graph G is simply the reverse of any
 230   // topological sorting S of G.
 231   auto topological_events = get_topological_ordering();
 232   std::reverse(topological_events.begin(), topological_events.end());
 233   return topological_events;
 234 }
 235
 236 std::vector<const UnfoldingEvent*> EventSet::move_into_vector() const&&
 237 {
 238   std::vector<const UnfoldingEvent*> contents;
 239   contents.reserve(size());
 240
 241   for (auto&& event : *this) {
 242     contents.push_back(event);
 243   }
 244
 245   return contents;
 246 }
 247
 248 } // namespace simgrid::mc::udpor