Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Reduce scope for variables.
[simgrid.git] / src / plugins / link_energy_wifi.cpp
index 33f677c..08e8a77 100644 (file)
@@ -1,4 +1,4 @@
-/* Copyright (c) 2017-2020. The SimGrid Team. All rights reserved.          */
+/* Copyright (c) 2017-2021. The SimGrid Team. All rights reserved.          */
 
 /* This program is free software; you can redistribute it and/or modify it
  * under the terms of the license (GNU LGPL) which comes with this package. */
@@ -20,8 +20,8 @@
 #include <map>
 
 SIMGRID_REGISTER_PLUGIN(link_energy_wifi, "Energy wifi test", &sg_wifi_energy_plugin_init);
-/** @degroup plugin_link_energy_wifi Plugin WiFi energy
- * 
+/** @defgroup plugin_link_energy_wifi Plugin WiFi energy
+ *
  * This is the WiFi energy plugin, accounting for the dissipated energy of WiFi links.
  */
 
@@ -31,24 +31,21 @@ namespace simgrid {
 namespace plugin {
 
 class XBT_PRIVATE LinkEnergyWifi {
-
 public:
   static simgrid::xbt::Extension<simgrid::s4u::Link, LinkEnergyWifi> EXTENSION_ID;
 
   explicit LinkEnergyWifi(simgrid::s4u::Link* ptr) : link_(ptr) {}
-
-  ~LinkEnergyWifi() = default;
   LinkEnergyWifi()  = delete;
 
   /**
    * Update the energy consumed by link_ when transmissions start or end
    */
   void update(const simgrid::kernel::resource::NetworkAction &);
-  
+
   /**
    * Update the energy consumed when link_ is destroyed
    */
-  void updateDestroy();
+  void update_destroy();
 
   /**
    * Fetches energy consumption values from the platform file.
@@ -60,26 +57,30 @@ public:
    */
   void init_watts_range_list();
 
-  double getConsumedEnergy(void) { return eDyn_ + eStat_; }
-  double getEdyn(void) {return eDyn_; }
-  double getEstat(void) {return eStat_; }
-  double getDurTxRx(void){return durTxRx;}
-  double getDurIdle(void){return durIdle;}
-  
-  void setpIdle(double value) { pIdle_ = value; }
-  void setpTx(double value) { pTx_ = value; }
-  void setpRx(double value) { pRx_ = value; }
-  void setpSleep(double value) { pSleep_ = value; }
-  
-  
+  double get_consumed_energy(void) const { return eDyn_ + eStat_; }
+  /** Get the dynamic part of the energy for this link */
+  double get_energy_dynamic(void) const { return eDyn_; }
+  double get_energy_static(void) const { return eStat_; }
+  double get_duration_comm(void) const { return dur_TxRx_; }
+  double get_duration_idle(void) const { return dur_idle_; }
+
+  /** Set the power consumed by this link while idle */
+  void set_power_idle(double value) { pIdle_ = value; }
+  /** Set the power consumed by this link while transmitting */
+  void set_power_tx(double value) { pTx_ = value; }
+  /** Set the power consumed by this link while receiving */
+  void set_power_rx(double value) { pRx_ = value; }
+  /** Set the power consumed by this link while sleeping */
+  void set_power_sleep(double value) { pSleep_ = value; }
+
 private:
   // associative array keeping size of data already sent for a given flow (required for interleaved actions)
   std::map<simgrid::kernel::resource::NetworkWifiAction*, std::pair<int, double>> flowTmp{};
 
   // WiFi link the plugin instance is attached to
   s4u::Link* link_{};
-  
-  // dynamic energy (active durations consumption)
+
+  // dynamic energy accumulated since the simulation start (active durations consumption)
   double eDyn_{0.0};
   // static energy (no activity consumption)
   double eStat_{0.0};
@@ -95,32 +96,33 @@ private:
   double pSleep_{0.10};
 
   // constant taking beacons into account (can be specified by the user)
-  double controlDuration_{0.0036};
+  double control_duration_{0.0036};
 
   // Measurements for report
-  double durTxRx{0};
-  double durIdle{0};
+  double dur_TxRx_{0}; // Duration of transmission
+  double dur_idle_{0}; // Duration of idle time
   bool valuesInit_{false};
 };
 
 xbt::Extension<s4u::Link, LinkEnergyWifi> LinkEnergyWifi::EXTENSION_ID;
 
-void LinkEnergyWifi::updateDestroy() {
-  simgrid::kernel::resource::NetworkWifiLink* wifi_link =
-    static_cast<simgrid::kernel::resource::NetworkWifiLink*>(link_->get_impl());
+void LinkEnergyWifi::update_destroy()
+{
+  auto const* wifi_link = static_cast<simgrid::kernel::resource::NetworkWifiLink*>(link_->get_impl());
   double duration = surf_get_clock() - prev_update_;
   prev_update_    = surf_get_clock();
 
-  durIdle += duration;
+  dur_idle_ += duration;
 
   // add IDLE energy usage, as well as beacons consumption since previous update
-  eDyn_ += duration * controlDuration_ * wifi_link->get_host_count() * pRx_;
-  eStat_ += (duration - (duration * controlDuration_)) * pIdle_ * (wifi_link->get_host_count() + 1);
+  eDyn_ += duration * control_duration_ * wifi_link->get_host_count() * pRx_;
+  eStat_ += (duration - (duration * control_duration_)) * pIdle_ * (wifi_link->get_host_count() + 1);
 
   XBT_DEBUG("finish eStat_ += %f * %f * (%d+1) | eStat = %f", duration, pIdle_, wifi_link->get_host_count(), eStat_);
 }
 
-void LinkEnergyWifi::update(const simgrid::kernel::resource::NetworkAction& action) {
+void LinkEnergyWifi::update(const simgrid::kernel::resource::NetworkAction&)
+{
   init_watts_range_list();
 
   double duration = surf_get_clock() - prev_update_;
@@ -130,32 +132,27 @@ void LinkEnergyWifi::update(const simgrid::kernel::resource::NetworkAction& acti
   if(duration < 1e-6)
     return;
 
-  simgrid::kernel::resource::NetworkWifiLink* wifi_link =
-      static_cast<simgrid::kernel::resource::NetworkWifiLink*>(link_->get_impl());
-  
-  const kernel::lmm::Variable* var;
+  auto const* wifi_link = static_cast<simgrid::kernel::resource::NetworkWifiLink*>(link_->get_impl());
+
   const kernel::lmm::Element* elem = nullptr;
 
   /**
    * We update the energy consumed by each flow active on the link since the previous update.
-   * To do this, we need to know how much time each flow has been effectively sending data on the WiFi link since the previous update (durUsage). 
-   * We compute this value using the size of the flow, 
-   * the amount of data already spent (using flowTmp), 
-   * as well as the bandwidth used by the flow since the previous update (using LMM variables)
-   * Since flows are sharing the medium, the total active duration on the link is equal to the transmission/reception duration used by the flow with the longest active time since the previous update 
+   *
+   * To do this, we need to know how much time each flow has been effectively sending data on the WiFi link since the
+   * previous update (durUsage).  We compute this value using the size of the flow, the amount of data already spent
+   * (using flowTmp), as well as the bandwidth used by the flow since the previous update (using LMM variables).  Since
+   * flows are sharing the medium, the total active duration on the link is equal to the transmission/reception duration
+   * used by the flow with the longest active time since the previous update
    */
   double durUsage = 0;
-  while((var = wifi_link->get_constraint()->get_variable(&elem))) {
+  while (const auto* var = wifi_link->get_constraint()->get_variable(&elem)) {
     auto* action = static_cast<kernel::resource::NetworkWifiAction*>(var->get_id());
     XBT_DEBUG("cost: %f action value: %f link rate 1: %f link rate 2: %f", action->get_cost(), action->get_variable()->get_value(), wifi_link->get_host_rate(&action->get_src()),wifi_link->get_host_rate(&action->get_dst()));
-    action->get_variable();
-    
-    double du = 0; // durUsage on the current flow
-    std::map<simgrid::kernel::resource::NetworkWifiAction *, std::pair<int, double>>::iterator it;
 
     if(action->get_variable()->get_value()) {
-      it = flowTmp.find(action);
-      
+      auto it = flowTmp.find(action);
+
       // if the flow has not been registered, initialize it: 0 bytes sent, and not updated since its creation timestamp
       if(it == flowTmp.end())
         flowTmp[action] = std::pair<int,double>(0, action->get_start_time());
@@ -166,7 +163,8 @@ void LinkEnergyWifi::update(const simgrid::kernel::resource::NetworkAction& acti
        * The active duration of the link is equal to the amount of data it had to send divided by the bandwidth on the link.
        * If this is longer than the duration since the previous update, active duration = now - previous_update
        */
-      du = (action->get_cost()-it->second.first) / action->get_variable()->get_value();
+      double du = // durUsage on the current flow
+          (action->get_cost() - it->second.first) / action->get_variable()->get_value();
 
       if(du > surf_get_clock()-it->second.second)
         du = surf_get_clock()-it->second.second;
@@ -188,7 +186,7 @@ void LinkEnergyWifi::update(const simgrid::kernel::resource::NetworkAction& acti
   XBT_DEBUG("durUsage: %f", durUsage);
 
   // beacons cost
-  eDyn_ += duration * controlDuration_ * wifi_link->get_host_count() * pRx_;
+  eDyn_ += duration * control_duration_ * wifi_link->get_host_count() * pRx_;
 
   /**
    * Same principle as ns3:
@@ -201,16 +199,14 @@ void LinkEnergyWifi::update(const simgrid::kernel::resource::NetworkAction& acti
     eStat_ += (duration - durUsage) * pIdle_ * (wifi_link->get_host_count() + 1);
     XBT_DEBUG("eDyn +=  %f * ((%d * %f) + %f) | eDyn = %f (durusage =%f)", durUsage, wifi_link->get_host_count(), pRx_,
               pTx_, eDyn_, durUsage);
-    durTxRx+=duration;
+    dur_TxRx_ += duration;
   }else{
-    durIdle+=duration;
-    eStat_ += (duration - (duration * controlDuration_)) * pIdle_ * (wifi_link->get_host_count() + 1);
+    dur_idle_ += duration;
+    eStat_ += (duration - (duration * control_duration_)) * pIdle_ * (wifi_link->get_host_count() + 1);
   }
 
   XBT_DEBUG("eStat_ += %f * %f * (%d+1) | eStat = %f", duration, pIdle_, wifi_link->get_host_count(), eStat_);
 }
-  
-
 
 void LinkEnergyWifi::init_watts_range_list()
 {
@@ -225,7 +221,7 @@ void LinkEnergyWifi::init_watts_range_list()
   const char* beacons_factor = this->link_->get_property("control_duration");
   if(beacons_factor != nullptr) {
     try {
-      controlDuration_ = std::stod(beacons_factor);
+      control_duration_ = std::stod(beacons_factor);
     } catch (const std::invalid_argument&) {
       throw std::invalid_argument(std::string("Invalid beacons factor value for link ") + this->link_->get_cname());
     }
@@ -280,10 +276,10 @@ using simgrid::plugin::LinkEnergyWifi;
 
 void sg_wifi_energy_plugin_init()
 {
-  XBT_DEBUG("Initialization wifi_energy plugin");
-
   if (LinkEnergyWifi::EXTENSION_ID.valid())
     return;
+
+  XBT_INFO("Activating the wifi_energy plugin.");
   LinkEnergyWifi::EXTENSION_ID = simgrid::s4u::Link::extension_create<LinkEnergyWifi>();
 
   /**
@@ -297,7 +293,7 @@ void sg_wifi_energy_plugin_init()
     // verify the link is appropriate to WiFi energy computations
     if (link.get_sharing_policy() == simgrid::s4u::Link::SharingPolicy::WIFI) {
       XBT_DEBUG("Wifi Link: %s, initialization of wifi energy plugin", link.get_cname());
-      LinkEnergyWifi* plugin = new LinkEnergyWifi(&link);
+      auto* plugin = new LinkEnergyWifi(&link);
       link.extension_set(plugin);
     } else {
       XBT_DEBUG("Not Wifi Link: %s, wifi energy on link not computed", link.get_cname());
@@ -307,21 +303,20 @@ void sg_wifi_energy_plugin_init()
   simgrid::s4u::Link::on_destruction.connect([](simgrid::s4u::Link const& link) {
     // output energy values if WiFi link
     if (link.get_sharing_policy() == simgrid::s4u::Link::SharingPolicy::WIFI) {
-      link.extension<LinkEnergyWifi>()->updateDestroy();
-      XBT_INFO("Link %s destroyed, consumed: %f J dyn: %f stat: %f durIdle: %f durTxRx: %f", link.get_cname(),
-        link.extension<LinkEnergyWifi>()->getConsumedEnergy(),
-        link.extension<LinkEnergyWifi>()->getEdyn(),
-        link.extension<LinkEnergyWifi>()->getEstat(),
-             link.extension<LinkEnergyWifi>()->getDurIdle(),
-             link.extension<LinkEnergyWifi>()->getDurTxRx()
-           );
+      link.extension<LinkEnergyWifi>()->update_destroy();
+      XBT_INFO(
+          "Link %s destroyed, consumed: %f J dyn: %f stat: %f durIdle: %f durTxRx: %f", link.get_cname(),
+          link.extension<LinkEnergyWifi>()->get_consumed_energy(),
+          link.extension<LinkEnergyWifi>()->get_energy_dynamic(), link.extension<LinkEnergyWifi>()->get_energy_static(),
+          link.extension<LinkEnergyWifi>()->get_duration_idle(), link.extension<LinkEnergyWifi>()->get_duration_comm());
     }
   });
 
   simgrid::s4u::Link::on_communication_state_change.connect(
-      [](simgrid::kernel::resource::NetworkAction const& action, simgrid::kernel::resource::Action::State previous) {
+      [](simgrid::kernel::resource::NetworkAction const& action,
+         simgrid::kernel::resource::Action::State /* previous */) {
         // update WiFi links encountered during the communication
-        for (simgrid::kernel::resource::LinkImpl* link : action.get_links()) {
+        for (auto const* link : action.get_links()) {
           if (link != nullptr && link->get_sharing_policy() == simgrid::s4u::Link::SharingPolicy::WIFI) {
             link->get_iface()->extension<LinkEnergyWifi>()->update(action);
           }
@@ -329,19 +324,17 @@ void sg_wifi_energy_plugin_init()
       });
 
   simgrid::s4u::Link::on_communicate.connect([](const simgrid::kernel::resource::NetworkAction& action) {
-    const simgrid::kernel::resource::NetworkWifiAction* actionWifi = dynamic_cast<const simgrid::kernel::resource::NetworkWifiAction*>(&action);
+    auto const* actionWifi = dynamic_cast<const simgrid::kernel::resource::NetworkWifiAction*>(&action);
 
-    if(actionWifi == nullptr) 
+    if (actionWifi == nullptr)
       return;
 
-    auto link_src  = actionWifi->get_src_link();
-    auto link_dst = actionWifi->get_dst_link();
+    auto const* link_src = actionWifi->get_src_link();
+    auto const* link_dst = actionWifi->get_dst_link();
 
     if(link_src != nullptr)
       link_src->get_iface()->extension<LinkEnergyWifi>()->update(action);
     if(link_dst != nullptr)
       link_dst->get_iface()->extension<LinkEnergyWifi>()->update(action);
-
   });
-
 }