examples/s4u/exec-ptask/s4u-exec-ptask.cpp

   1 /* Copyright (c) 2017. 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 /* Parallel tasks are convenient abstractions of parallel computational kernels that span over several machines.
   7  * To create a new one, you have to provide several things:
   8  *   - a vector of hosts on which the task will execute
   9  *   - a vector of values, the amount of computation for each of the hosts (in flops)
  10  *   - a matrix of values, the amount of communication between each pair of hosts (in bytes)
  11  *
  12  * Each of these operation will be processed at the same relative speed.
  13  * This means that at some point in time, all sub-executions and all sub-communications will be at 20% of completion.
  14  * Also, they will all complete at the exact same time.
  15  *
  16  * This is obviously a simplistic abstraction, but this is very handful in a large amount of situations.
  17  *
  18  * Please note that you must have the LV07 platform model enabled to use such constructs.
  19  */
  20
  21 #include "simgrid/plugins/energy.h"
  22 #include <simgrid/s4u.hpp>
  23 #include <xbt/ex.hpp>
  24 #include <xbt/log.h>
  25
  26 XBT_LOG_NEW_DEFAULT_CATEGORY(s4u_energyptask, "Messages specific for this s4u example");
  27
  28 static void runner()
  29 {
  30   /* Retrieve the list of all hosts as an array of hosts */
  31   std::vector<simgrid::s4u::Host*> hosts;
  32   simgrid::s4u::Engine::getInstance()->getHostList(&hosts);
  33   int hosts_count = hosts.size();
  34
  35   XBT_INFO("First, build a classical parallel task, with 1 Gflop to execute on each node, "
  36            "and 10MB to exchange between each pair");
  37   double* computation_amounts   = new double[hosts_count]();
  38   double* communication_amounts = new double[hosts_count * hosts_count]();
  39
  40   for (int i               = 0; i < hosts_count; i++)
  41     computation_amounts[i] = 1e9; // 1 Gflop
  42
  43   for (int i = 0; i < hosts_count; i++)
  44     for (int j = i + 1; j < hosts_count; j++)
  45       communication_amounts[i * hosts_count + j] = 1e7; // 10 MB
  46
  47   simgrid::s4u::this_actor::parallel_execute(hosts_count, hosts.data(), computation_amounts, communication_amounts);
  48
  49   XBT_INFO("We can do the same with a timeout of one second enabled.");
  50   computation_amounts   = new double[hosts_count]();
  51   communication_amounts = new double[hosts_count * hosts_count]();
  52
  53   for (int i               = 0; i < hosts_count; i++)
  54     computation_amounts[i] = 1e9; // 1 Gflop
  55
  56   for (int i = 0; i < hosts_count; i++)
  57     for (int j = i + 1; j < hosts_count; j++)
  58       communication_amounts[i * hosts_count + j] = 1e7; // 10 MB
  59
  60   try {
  61     simgrid::s4u::this_actor::parallel_execute(hosts_count, hosts.data(), computation_amounts, communication_amounts,
  62                                                1.0 /* timeout (in seconds)*/);
  63     XBT_WARN("Woops, this did not timeout as expected... Please report that bug.");
  64   } catch (xbt_ex& e) {
  65     /* Do nothing this exception on timeout was expected */
  66     XBT_DEBUG("Caught expected exception: %s", e.what());
  67   }
  68
  69   XBT_INFO("Then, build a parallel task involving only computations and no communication (1 Gflop per node)");
  70   computation_amounts = new double[hosts_count]();
  71   for (int i               = 0; i < hosts_count; i++)
  72     computation_amounts[i] = 1e9; // 1 Gflop
  73   simgrid::s4u::this_actor::parallel_execute(hosts_count, hosts.data(), computation_amounts, nullptr /* no comm */);
  74
  75   XBT_INFO("Then, build a parallel task with no computation nor communication (synchro only)");
  76   computation_amounts   = new double[hosts_count]();
  77   communication_amounts = new double[hosts_count * hosts_count]();
  78   simgrid::s4u::this_actor::parallel_execute(hosts_count, hosts.data(), computation_amounts, communication_amounts);
  79
  80   XBT_INFO("Finally, trick the ptask to do a 'remote execution', on host %s", hosts[1]->getCname());
  81   computation_amounts = new double[1]{1e9};
  82
  83   simgrid::s4u::Host* remote[] = {hosts[1]};
  84   simgrid::s4u::this_actor::parallel_execute(1, remote, computation_amounts, nullptr);
  85
  86   XBT_INFO("Goodbye now!");
  87 }
  88
  89 int main(int argc, char* argv[])
  90 {
  91   simgrid::s4u::Engine e(&argc, argv);
  92
  93   xbt_assert(argc <= 3, "1Usage: %s <platform file> [--energy]", argv[0]);
  94   xbt_assert(argc >= 2, "2Usage: %s <platform file> [--energy]", argv[0]);
  95
  96   if (argc == 3 && argv[2][2] == 'e')
  97     sg_host_energy_plugin_init();
  98
  99   e.loadPlatform(argv[1]);
 100
 101   /* Pick a process, no matter which, from the platform file */
 102   simgrid::s4u::Actor::createActor("test", simgrid::s4u::Host::by_name("MyHost1"), runner);
 103
 104   e.run();
 105   XBT_INFO("Simulation done.");
 106   return 0;
 107 }