docs/source/application.rst

   1 .. _application:
   2
   3 Describing your Application
   4 ***************************
   5
   6 .. raw:: html
   7
   8    <object id="TOC" data="graphical-toc.svg" type="image/svg+xml"></object>
   9    <script>
  10    window.onload=function() { // Wait for the SVG to be loaded before changing it
  11      var elem=document.querySelector("#TOC").contentDocument.getElementById("ApplicationBox")
  12      elem.style="opacity:0.93999999;fill:#ff0000;fill-opacity:0.1;stroke:#000000;stroke-width:0.35277778;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1";
  13    }
  14    </script>
  15    <br/>
  16    <br/>
  17
  18 Every SimGrid simulation entails a distributed application, that
  19 virtually executes on the simulated platform. You can express this
  20 application using one of the following interfaces. It is even possible
  21 to mix several interfaces in the same simulation.
  22
  23  - :ref:`Describing Algorithms with the S4U interface <S4U_doc>` (in C++ or Python)
  24  - :ref:`Simulating existing MPI programs with the SMPI toolsuite <SMPI_doc>`
  25    (in C, C++, or Fortran)
  26  - In some cases, you may want to replay an execution trace in the simulator. This
  27    trace lists the events of your application or of your workload, and
  28    your application is decomposed as a list of event handlers that are
  29    fired according to the trace. SimGrid comes with a built-in support
  30    for MPI traces (with solutions to import traces captured by several
  31    MPI profilers). You can reuse this mechanism for any kind of trace
  32    that you want to replay, for example to study how a P2P DHT overlay
  33    reacts to a given workload.
  34  - A prototypal tool is intended to allow the modification of any existing
  35    application so that it can run on top of SimGrid. This project,
  36    called `Remote-SimGrid
  37    <https://framagit.org/simgrid/remote-simgrid>`_, is somewhat
  38    experimental but should be already usable.
  39
  40 As you can see, SimGrid is very modular and can be used in many
  41 ways. We are working to improve it along two main directions. First,
  42 we plan to further increase the modularity of the simulator so that
  43 users can invent the specific API or DSL they need for their usage. We
  44 call this project BYOS: Build Your Own Simulator.
  45
  46 Executing existing applications within the simulator is another
  47 long-term goal. SMPI and Remote-SimGrid already allow you to execute some
  48 applications, but our long term goal would be to allow for the execution
  49 of any legacy application, with absolutely no modification. We call it
  50 SimOS, even if it will not become usable before several years of
  51 additional work.