1 /* Copyright (c) 2010-2019. The SimGrid Team. All rights reserved. */
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. */
6 #include "simgrid/plugins/energy.h"
7 #include "simgrid/s4u/Engine.hpp"
8 #include "simgrid/s4u/Exec.hpp"
9 #include "src/include/surf/surf.hpp"
10 #include "src/kernel/activity/ExecImpl.hpp"
11 #include "src/plugins/vm/VirtualMachineImpl.hpp"
12 #include "src/surf/cpu_interface.hpp"
14 #include <boost/algorithm/string/classification.hpp>
15 #include <boost/algorithm/string/split.hpp>
17 SIMGRID_REGISTER_PLUGIN(host_energy, "Cpu energy consumption.", &sg_host_energy_plugin_init)
19 /** @defgroup plugin_host_energy
22 This is the energy plugin, enabling to account not only for computation time, but also for the dissipated energy in the
24 To activate this plugin, first call :cpp:func:`sg_host_energy_plugin_init()` before your :cpp:func:`MSG_init()`, and then use
25 :cpp:func:`MSG_host_get_consumed_energy()` to retrieve the consumption of a given host.
27 When the host is on, this energy consumption naturally depends on both the current CPU load and the host energy profile.
28 According to our measurements, the consumption is somehow linear in the amount of cores at full speed, with an
29 abnormality when all the cores are idle. The full details are in `our scientific paper <https://hal.inria.fr/hal-01523608>`_
32 As a result, our energy model takes 4 parameters:
34 - ``Idle`` wattage (i.e., instantaneous consumption in Watt) when your host is up and running, but without anything to do.
35 - ``Epsilon`` wattage when all cores are at 0 or epsilon%, but not in Idle state.
36 - ``AllCores`` wattage when all cores of the host are at 100%.
37 - ``Off`` wattage when the host is turned off.
39 Here is an example of XML declaration:
43 <host id="HostA" speed="100.0Mf" core="4">
44 <prop id="wattage_per_state" value="100.0:120.0:200.0" />
45 <prop id="wattage_off" value="10" />
48 If only two values are given, ``Idle`` is used for the missing ``Epsilon`` value.
50 This example gives the following parameters: ``Off`` is 10 Watts; ``Idle`` is 100 Watts; ``Epsilon`` is 120 Watts and
51 ``AllCores`` is 200 Watts.
52 This is enough to compute the wattage as a function of the amount of loaded cores:
57 <tr><th>#Cores loaded</th><th>Wattage</th><th>Explanation</th></tr>
58 <tr><td>0 (idle)</td><td> 100 Watts </td><td> Idle value</td></tr>
59 <tr><td>0 (not idle)</td><td> 120 Watts</td><td> Epsilon value</td></tr>
60 <tr><td>1</td><td> 140 Watts</td><td> Linear extrapolation between Epsilon and AllCores</td></tr>
61 <tr><td>2</td><td> 160 Watts</td><td> Linear extrapolation between Epsilon and AllCores</td></tr>
62 <tr><td>3</td><td> 180 Watts</td><td> Linear extrapolation between Epsilon and AllCores</td></tr>
63 <tr><td>4</td><td> 200 Watts</td><td> AllCores value</td></tr>
69 <h4>How does DVFS interact with the host energy model?</h4>
71 If your host has several DVFS levels (several pstates), then you should give the energetic profile of each pstate level:
75 <host id="HostC" speed="100.0Mf,50.0Mf,20.0Mf" core="4">
76 <prop id="wattage_per_state"
77 value="95.0:120.0:200.0, 93.0:115.0:170.0, 90.0:110.0:150.0" />
78 <prop id="wattage_off" value="10" />
81 This encodes the following values:
86 <tr><th>pstate</th><th>Performance</th><th>Idle</th><th>Epsilon</th><th>AllCores</th></tr>
87 <tr><td>0</td><td>100 Mflop/s</td><td>95 Watts</td><td>120 Watts</td><td>200 Watts</td></tr>
88 <tr><td>1</td><td>50 Mflop/s</td><td>93 Watts</td><td>115 Watts</td><td>170 Watts</td></tr>
89 <tr><td>2</td><td>20 Mflop/s</td><td>90 Watts</td><td>110 Watts</td><td>150 Watts</td></tr>
92 To change the pstate of a given CPU, use the following functions:
93 :cpp:func:`MSG_host_get_nb_pstates()`, :cpp:func:`simgrid::s4u::Host::set_pstate()`, :cpp:func:`MSG_host_get_power_peak_at()`.
97 <h4>How accurate are these models?</h4>
99 This model cannot be more accurate than your instantiation: with the default values, your result will not be accurate at
100 all. You can still get accurate energy prediction, provided that you carefully instantiate the model.
101 The first step is to ensure that your timing prediction match perfectly. But this is only the first step of the path,
102 and you really want to read `this paper <https://hal.inria.fr/hal-01523608>`_ to see all what you need to do
103 before you can get accurate energy predictions.
108 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(surf_energy, surf, "Logging specific to the SURF energy plugin");
110 // Forwards declaration needed to make this function a friend (because friends have external linkage by default)
111 static void on_simulation_end();
123 PowerRange(double idle, double epsilon, double max) : idle_(idle), epsilon_(epsilon), max_(max), slope_(max-epsilon) {}
127 friend void ::on_simulation_end(); // For access to host_was_used_
129 static simgrid::xbt::Extension<simgrid::s4u::Host, HostEnergy> EXTENSION_ID;
131 explicit HostEnergy(simgrid::s4u::Host* ptr);
134 double get_current_watts_value();
135 double get_current_watts_value(double cpu_load);
136 double get_consumed_energy();
137 double get_watt_idle_at(int pstate);
138 double get_watt_min_at(int pstate);
139 double get_watt_max_at(int pstate);
140 double get_power_range_slope_at(int pstate);
144 void init_watts_range_list();
145 simgrid::s4u::Host* host_ = nullptr;
146 /*< List of (idle_power, epsilon_power, max_power) tuple corresponding to each cpu pstate */
147 std::vector<PowerRange> power_range_watts_list_;
149 /* We need to keep track of what pstate has been used, as we will sometimes be notified only *after* a pstate has been
150 * used (but we need to update the energy consumption with the old pstate!)
153 const int pstate_off_ = -1;
155 /* Only used to split total energy into unused/used hosts.
156 * If you want to get this info for something else, rather use the host_load plugin
158 bool host_was_used_ = false;
160 double watts_off_ = 0.0; /*< Consumption when the machine is turned off (shutdown) */
161 double total_energy_ = 0.0; /*< Total energy consumed by the host */
162 double last_updated_; /*< Timestamp of the last energy update event*/
165 simgrid::xbt::Extension<simgrid::s4u::Host, HostEnergy> HostEnergy::EXTENSION_ID;
167 /* Computes the consumption so far. Called lazily on need. */
168 void HostEnergy::update()
170 double start_time = this->last_updated_;
171 double finish_time = surf_get_clock();
173 // We may have start == finish if the past consumption was updated since the simcall was started
174 // for example if 2 actors requested to update the same host's consumption in a given scheduling round.
176 // Even in this case, we need to save the pstate for the next call (after this if),
177 // which may have changed since that recent update.
178 if (start_time < finish_time) {
179 double previous_energy = this->total_energy_;
181 double instantaneous_power_consumption = this->get_current_watts_value();
183 double energy_this_step = instantaneous_power_consumption * (finish_time - start_time);
185 // TODO Trace: Trace energy_this_step from start_time to finish_time in host->getName()
187 this->total_energy_ = previous_energy + energy_this_step;
188 this->last_updated_ = finish_time;
190 XBT_DEBUG("[update_energy of %s] period=[%.8f-%.8f]; current speed=%.2E flop/s (pstate %i); total consumption before: %.8f J -> added now: %.8f J",
191 host_->get_cname(), start_time, finish_time, host_->pimpl_cpu->get_pstate_peak_speed(this->pstate_), this->pstate_, previous_energy,
195 /* Save data for the upcoming time interval: whether it's on/off and the pstate if it's on */
196 this->pstate_ = host_->is_on() ? host_->get_pstate() : pstate_off_;
199 HostEnergy::HostEnergy(simgrid::s4u::Host* ptr) : host_(ptr), last_updated_(surf_get_clock())
201 init_watts_range_list();
202 static bool warned = false;
204 const char* off_power_str = host_->get_property("wattage_off");
205 if (off_power_str == nullptr) {
206 off_power_str = host_->get_property("watt_off");
207 if (off_power_str != nullptr && not warned) {
209 XBT_WARN("Please use 'wattage_off' instead of 'watt_off' to define the idle wattage of hosts in your XML.");
212 if (off_power_str != nullptr) {
214 this->watts_off_ = std::stod(std::string(off_power_str));
215 } catch (const std::invalid_argument&) {
216 throw std::invalid_argument(std::string("Invalid value for property wattage_off of host ") + host_->get_cname() +
217 ": " + off_power_str);
220 /* watts_off is 0 by default */
223 HostEnergy::~HostEnergy() = default;
225 double HostEnergy::get_watt_idle_at(int pstate)
227 xbt_assert(not power_range_watts_list_.empty(), "No power range properties specified for host %s",
229 return power_range_watts_list_[pstate].idle_;
232 double HostEnergy::get_watt_min_at(int pstate)
234 xbt_assert(not power_range_watts_list_.empty(), "No power range properties specified for host %s",
236 return power_range_watts_list_[pstate].epsilon_;
239 double HostEnergy::get_watt_max_at(int pstate)
241 xbt_assert(not power_range_watts_list_.empty(), "No power range properties specified for host %s",
243 return power_range_watts_list_[pstate].max_;
246 double HostEnergy::get_power_range_slope_at(int pstate)
248 xbt_assert(not power_range_watts_list_.empty(), "No power range properties specified for host %s",
250 return power_range_watts_list_[pstate].slope_;
253 /** @brief Computes the power consumed by the host according to the current situation
255 * - If the host is off, that's the watts_off value
256 * - if it's on, take the current pstate and the current processor load into account */
257 double HostEnergy::get_current_watts_value()
259 if (this->pstate_ == pstate_off_) // The host is off (or was off at the beginning of this time interval)
260 return this->watts_off_;
262 double current_speed = host_->get_pstate_speed(this->pstate_);
266 if (current_speed <= 0)
267 // Some users declare a pstate of speed 0 flops (e.g., to model boot time).
268 // We consider that the machine is then fully loaded. That's arbitrary but it avoids a NaN
271 cpu_load = host_->pimpl_cpu->get_constraint()->get_usage() / current_speed;
273 /* Divide by the number of cores here to have a value between 0 and 1 */
274 cpu_load /= host_->pimpl_cpu->get_core_count();
276 if (cpu_load > 1) // This condition is true for energy_ptask on 32 bits, even if cpu_load is displayed as 1.000000
277 cpu_load = 1; // That may be an harmless rounding error?
279 host_was_used_ = true;
282 return get_current_watts_value(cpu_load);
285 /** @brief Computes the power that the host would consume at the provided processor load
287 * Whether the host is ON or OFF is not taken into account.
289 double HostEnergy::get_current_watts_value(double cpu_load)
291 xbt_assert(not power_range_watts_list_.empty(), "No power range properties specified for host %s",
294 /* Return watts_off if pstate == pstate_off (ie, if the host is off) */
295 if (this->pstate_ == pstate_off_) {
299 PowerRange power_range = power_range_watts_list_.at(this->pstate_);
300 double current_power;
305 * Something is going on, the host is not idle.
307 * The power consumption follows the regular model:
308 * P(cpu_load) = Pstatic + Pdynamic * cpu_load
309 * where Pstatic = power_range.epsilon_ and Pdynamic = power_range.slope_
310 * and the cpu_load is a value between 0 and 1.
312 current_power = power_range.epsilon_ + cpu_load * power_range.slope_;
316 /* The host is idle, take the dedicated value! */
317 current_power = power_range.idle_;
320 XBT_DEBUG("[get_current_watts] pstate=%i, epsilon_power=%f, max_power=%f, slope=%f", this->pstate_, power_range.epsilon_,
321 power_range.max_, power_range.slope_);
322 XBT_DEBUG("[get_current_watts] Current power (watts) = %f, load = %f", current_power, cpu_load);
324 return current_power;
327 double HostEnergy::get_consumed_energy()
329 if (last_updated_ < surf_get_clock()) // We need to simcall this as it modifies the environment
330 simgrid::kernel::actor::simcall(std::bind(&HostEnergy::update, this));
332 return total_energy_;
335 void HostEnergy::init_watts_range_list()
337 const char* old_prop = host_->get_property("watt_per_state");
338 if (old_prop != nullptr) {
339 std::vector<std::string> all_power_values;
340 boost::split(all_power_values, old_prop, boost::is_any_of(","));
342 xbt_assert(all_power_values.size() == (unsigned)host_->get_pstate_count(),
343 "Invalid XML file. Found %lu energetic profiles for %d pstates",
344 all_power_values.size(), host_->get_pstate_count());
346 std::string msg = std::string("DEPRECATION WARNING: Property 'watt_per_state' will not work after v3.28.\n");
347 msg += std::string("The old syntax 'Idle:OneCore:AllCores' must be converted into 'Idle:Epsilon:AllCores' to "
348 "properly model the consumption of non-whole tasks on mono-core hosts. Here are the values to "
350 host_->get_cname() + "' in your XML file:\n";
351 msg += " <prop id=\"wattage_per_state\" value=\"";
352 for (auto const& current_power_values_str : all_power_values) {
353 std::vector<std::string> current_power_values;
354 boost::split(current_power_values, current_power_values_str, boost::is_any_of(":"));
355 double p_idle = xbt_str_parse_double((current_power_values.at(0)).c_str(),
356 "Invalid obsolete XML file. Fix your watt_per_state property.");
361 if (current_power_values.size() == 3) {
362 p_idle = xbt_str_parse_double((current_power_values.at(0)).c_str(),
363 "Invalid obsolete XML file. Fix your watt_per_state property.");
364 p_one_core = xbt_str_parse_double((current_power_values.at(1)).c_str(),
365 "Invalid obsolete XML file. Fix your watt_per_state property.");
366 p_full = xbt_str_parse_double((current_power_values.at(2)).c_str(),
367 "Invalid obsolete XML file. Fix your watt_per_state property.");
368 if (host_->get_core_count() == 1) {
371 p_epsilon = p_one_core - ((p_full - p_one_core) / (host_->get_core_count() - 1));
373 } else { // consuption given with idle and full only
374 p_idle = xbt_str_parse_double((current_power_values.at(0)).c_str(),
375 "Invalid obsolete XML file. Fix your watt_per_state property.");
376 p_full = xbt_str_parse_double((current_power_values.at(1)).c_str(),
377 "Invalid obsolete XML file. Fix your watt_per_state property.");
378 if (host_->get_core_count() == 1) {
385 PowerRange range(p_idle, p_epsilon, p_full);
386 power_range_watts_list_.push_back(range);
388 msg += std::to_string(p_idle) + ":" + std::to_string(p_epsilon) + ":" + std::to_string(p_full);
391 msg.pop_back(); // Remove the extraneous ','
393 XBT_WARN("%s", msg.c_str());
397 const char* all_power_values_str = host_->get_property("wattage_per_state");
398 if (all_power_values_str == nullptr) {
399 /* If no power values are given, we assume it's 0 everywhere */
400 XBT_DEBUG("No energetic profiles given for host %s, using 0 W by default.", host_->get_cname());
401 for (int i = 0; i < host_->get_pstate_count(); ++i) {
402 PowerRange range(0,0,0);
403 power_range_watts_list_.push_back(range);
408 std::vector<std::string> all_power_values;
409 boost::split(all_power_values, all_power_values_str, boost::is_any_of(","));
410 XBT_DEBUG("%s: power properties: %s", host_->get_cname(), all_power_values_str);
412 xbt_assert(all_power_values.size() == (unsigned)host_->get_pstate_count(),
413 "Invalid XML file. Found %lu energetic profiles for %d pstates",
414 all_power_values.size(), host_->get_pstate_count());
417 for (auto const& current_power_values_str : all_power_values) {
418 /* retrieve the power values associated with the pstate i */
419 std::vector<std::string> current_power_values;
420 boost::split(current_power_values, current_power_values_str, boost::is_any_of(":"));
422 xbt_assert(current_power_values.size() == 2 || current_power_values.size() == 3,
423 "Power properties incorrectly defined for host %s."
424 "It should be 'Idle:AllCores' (or 'Idle:Epsilon:AllCores') power values.",
428 double epsilon_power;
431 char* msg_idle = bprintf("Invalid Idle value for pstate %d on host %s: %%s", i, host_->get_cname());
432 char* msg_epsilon = bprintf("Invalid Epsilon value for pstate %d on host %s: %%s", i, host_->get_cname());
433 char* msg_max = bprintf("Invalid AllCores value for pstate %d on host %s: %%s", i, host_->get_cname());
435 idle_power = xbt_str_parse_double((current_power_values.at(0)).c_str(), msg_idle);
436 if (current_power_values.size() == 2) { // Case: Idle:AllCores
437 epsilon_power = xbt_str_parse_double((current_power_values.at(0)).c_str(), msg_idle);
438 max_power = xbt_str_parse_double((current_power_values.at(1)).c_str(), msg_max);
439 } else { // Case: Idle:Epsilon:AllCores
440 epsilon_power = xbt_str_parse_double((current_power_values.at(1)).c_str(), msg_epsilon);
441 max_power = xbt_str_parse_double((current_power_values.at(2)).c_str(), msg_max);
444 XBT_DEBUG("Creating PowerRange for host %s. Idle:%f, Epsilon:%f, AllCores:%f.", host_->get_cname(), idle_power, epsilon_power, max_power);
446 PowerRange range(idle_power, epsilon_power, max_power);
447 power_range_watts_list_.push_back(range);
449 xbt_free(msg_epsilon);
454 } // namespace plugin
455 } // namespace simgrid
457 using simgrid::plugin::HostEnergy;
459 /* **************************** events callback *************************** */
460 static void on_creation(simgrid::s4u::Host& host)
462 if (dynamic_cast<simgrid::s4u::VirtualMachine*>(&host)) // Ignore virtual machines
465 // TODO Trace: set to zero the energy variable associated to host->getName()
467 host.extension_set(new HostEnergy(&host));
470 static void on_action_state_change(simgrid::kernel::resource::CpuAction const& action,
471 simgrid::kernel::resource::Action::State /*previous*/)
473 for (simgrid::kernel::resource::Cpu* const& cpu : action.cpus()) {
474 simgrid::s4u::Host* host = cpu->get_host();
475 if (host != nullptr) {
477 // If it's a VM, take the corresponding PM
478 simgrid::s4u::VirtualMachine* vm = dynamic_cast<simgrid::s4u::VirtualMachine*>(host);
479 if (vm) // If it's a VM, take the corresponding PM
482 // Get the host_energy extension for the relevant host
483 HostEnergy* host_energy = host->extension<HostEnergy>();
485 if (host_energy->last_updated_ < surf_get_clock())
486 host_energy->update();
491 /* This callback is fired either when the host changes its state (on/off) ("onStateChange") or its speed
492 * (because the user changed the pstate, or because of external trace events) ("onSpeedChange") */
493 static void on_host_change(simgrid::s4u::Host const& host)
495 if (dynamic_cast<simgrid::s4u::VirtualMachine const*>(&host)) // Ignore virtual machines
498 HostEnergy* host_energy = host.extension<HostEnergy>();
500 host_energy->update();
503 static void on_host_destruction(simgrid::s4u::Host const& host)
505 if (dynamic_cast<simgrid::s4u::VirtualMachine const*>(&host)) // Ignore virtual machines
508 XBT_INFO("Energy consumption of host %s: %f Joules", host.get_cname(),
509 host.extension<HostEnergy>()->get_consumed_energy());
512 static void on_simulation_end()
514 std::vector<simgrid::s4u::Host*> hosts = simgrid::s4u::Engine::get_instance()->get_all_hosts();
516 double total_energy = 0.0; // Total energy consumption (whole platform)
517 double used_hosts_energy = 0.0; // Energy consumed by hosts that computed something
518 for (size_t i = 0; i < hosts.size(); i++) {
519 if (dynamic_cast<simgrid::s4u::VirtualMachine*>(hosts[i]) == nullptr) { // Ignore virtual machines
521 double energy = hosts[i]->extension<HostEnergy>()->get_consumed_energy();
522 total_energy += energy;
523 if (hosts[i]->extension<HostEnergy>()->host_was_used_)
524 used_hosts_energy += energy;
527 XBT_INFO("Total energy consumption: %f Joules (used hosts: %f Joules; unused/idle hosts: %f)", total_energy,
528 used_hosts_energy, total_energy - used_hosts_energy);
531 /* **************************** Public interface *************************** */
533 /** @ingroup plugin_host_energy
534 * @brief Enable host energy plugin
535 * @details Enable energy plugin to get joules consumption of each cpu. Call this function before #MSG_init().
537 void sg_host_energy_plugin_init()
539 if (HostEnergy::EXTENSION_ID.valid())
542 HostEnergy::EXTENSION_ID = simgrid::s4u::Host::extension_create<HostEnergy>();
544 simgrid::s4u::Host::on_creation.connect(&on_creation);
545 simgrid::s4u::Host::on_state_change.connect(&on_host_change);
546 simgrid::s4u::Host::on_speed_change.connect(&on_host_change);
547 simgrid::s4u::Host::on_destruction.connect(&on_host_destruction);
548 simgrid::s4u::Engine::on_simulation_end.connect(&on_simulation_end);
549 simgrid::kernel::resource::CpuAction::on_state_change.connect(&on_action_state_change);
550 // We may only have one actor on a node. If that actor executes something like
551 // compute -> recv -> compute
552 // the recv operation will not trigger a "CpuAction::on_state_change". This means
553 // that the next trigger would be the 2nd compute, hence ignoring the idle time
554 // during the recv call. By updating at the beginning of a compute, we can
555 // fix that. (If the cpu is not idle, this is not required.)
556 simgrid::s4u::Exec::on_start.connect([](simgrid::s4u::Actor const&, simgrid::s4u::Exec const& activity) {
557 if (activity.get_host_number() == 1) { // We only run on one host
558 simgrid::s4u::Host* host = activity.get_host();
559 simgrid::s4u::VirtualMachine* vm = dynamic_cast<simgrid::s4u::VirtualMachine*>(host);
562 xbt_assert(host != nullptr);
563 host->extension<HostEnergy>()->update();
568 /** @ingroup plugin_host_energy
569 * @brief updates the consumption of all hosts
571 * After this call, sg_host_get_consumed_energy() will not interrupt your process
572 * (until after the next clock update).
574 void sg_host_energy_update_all()
576 simgrid::kernel::actor::simcall([]() {
577 std::vector<simgrid::s4u::Host*> list = simgrid::s4u::Engine::get_instance()->get_all_hosts();
578 for (auto const& host : list)
579 if (dynamic_cast<simgrid::s4u::VirtualMachine*>(host) == nullptr) { // Ignore virtual machines
580 xbt_assert(host != nullptr);
581 host->extension<HostEnergy>()->update();
586 /** @ingroup plugin_host_energy
587 * @brief Returns the total energy consumed by the host so far (in Joules)
589 * Please note that since the consumption is lazily updated, it may require a simcall to update it.
590 * The result is that the actor requesting this value will be interrupted,
591 * the value will be updated in kernel mode before returning the control to the requesting actor.
593 double sg_host_get_consumed_energy(sg_host_t host)
595 xbt_assert(HostEnergy::EXTENSION_ID.valid(),
596 "The Energy plugin is not active. Please call sg_host_energy_plugin_init() during initialization.");
597 return host->extension<HostEnergy>()->get_consumed_energy();
600 /** @ingroup plugin_host_energy
601 * @brief Get the amount of watt dissipated when the host is idling
602 * This function is deprecated and will not work after v3.27. Use sg_host_get_idle_consumption_at instead.
604 double sg_host_get_idle_consumption(sg_host_t host)
606 xbt_assert(HostEnergy::EXTENSION_ID.valid(),
607 "The Energy plugin is not active. Please call sg_host_energy_plugin_init() during initialization.");
608 return host->extension<HostEnergy>()->get_watt_idle_at(0);
611 /** @ingroup plugin_host_energy
612 * @brief Get the amount of watt dissipated at the given pstate when the host is idling
614 double sg_host_get_idle_consumption_at(sg_host_t host, int pstate)
616 xbt_assert(HostEnergy::EXTENSION_ID.valid(),
617 "The Energy plugin is not active. Please call sg_host_energy_plugin_init() during initialization.");
618 return host->extension<HostEnergy>()->get_watt_idle_at(pstate);
621 /** @ingroup plugin_host_energy
622 * @brief Get the amount of watt dissipated at the given pstate when the host is at 0 or epsilon% CPU usage.
624 double sg_host_get_wattmin_at(sg_host_t host, int pstate)
626 xbt_assert(HostEnergy::EXTENSION_ID.valid(),
627 "The Energy plugin is not active. Please call sg_host_energy_plugin_init() during initialization.");
628 return host->extension<HostEnergy>()->get_watt_min_at(pstate);
630 /** @ingroup plugin_host_energy
631 * @brief Returns the amount of watt dissipated at the given pstate when the host burns CPU at 100%
633 double sg_host_get_wattmax_at(sg_host_t host, int pstate)
635 xbt_assert(HostEnergy::EXTENSION_ID.valid(),
636 "The Energy plugin is not active. Please call sg_host_energy_plugin_init() during initialization.");
637 return host->extension<HostEnergy>()->get_watt_max_at(pstate);
639 /** @ingroup plugin_host_energy
640 * @brief Returns the power slope at the given pstate
642 double sg_host_get_power_range_slope_at(sg_host_t host, int pstate)
644 xbt_assert(HostEnergy::EXTENSION_ID.valid(),
645 "The Energy plugin is not active. Please call sg_host_energy_plugin_init() during initialization.");
646 return host->extension<HostEnergy>()->get_power_range_slope_at(pstate);
648 /** @ingroup plugin_host_energy
649 * @brief Returns the current consumption of the host
651 double sg_host_get_current_consumption(sg_host_t host)
653 xbt_assert(HostEnergy::EXTENSION_ID.valid(),
654 "The Energy plugin is not active. Please call sg_host_energy_plugin_init() during initialization.");
655 return host->extension<HostEnergy>()->get_current_watts_value();