From 734f9e5ac810cc97357f292240bc5758f213733a Mon Sep 17 00:00:00 2001 From: Martin Quinson Date: Wed, 12 Sep 2018 01:53:17 +0200 Subject: [PATCH] SMPI tuto: Start stealing content from SMPI courseware --- docs/source/tuto_smpi.rst | 42 +++++++++++++++++++++++++++ docs/source/tuto_smpi/3hosts.xml | 15 ++++++++++ docs/source/tuto_smpi/img/3hosts.png | Bin 0 -> 10490 bytes 3 files changed, 57 insertions(+) create mode 100644 docs/source/tuto_smpi/3hosts.xml create mode 100644 docs/source/tuto_smpi/img/3hosts.png diff --git a/docs/source/tuto_smpi.rst b/docs/source/tuto_smpi.rst index f7f2476d6d..1fc7afa5d3 100644 --- a/docs/source/tuto_smpi.rst +++ b/docs/source/tuto_smpi.rst @@ -68,5 +68,47 @@ time is reported into the simulator. Describing Your Platform ======================== +As a SMPI user, you are supposed to provide a description of your +virtual platform, that is mostly a set of simulated hosts and network +links with some performance characteristics. SimGrid provides a plenty +of :ref:`documentation `_ and examples (in the +`examples/platform `_ +source directory), and this section only show a series of introductory +examples. + +Simple Example with 3 hosts +--------------------------- + +At the most basic level, you can describe your simulated platform as a +graph of hosts and network links. For instance: + +.. image:: /tuto_smpi/img/3hosts.png + :align: center + +.. hidden-code-block:: xml + :starthidden: True + :label: See the XML platform description file... + + + + + + + + + + + + + + + + + +In this XML, note the way in which hosts, links, and routes are +defined. All hosts are defined with a power (i.e., compute speed in +Gflops), and links with a latency (in us) and bandwidth (in MBytes per +second). Other units are possible and written as expected. By default, +routes are symmetrical. .. LocalWords: SimGrid diff --git a/docs/source/tuto_smpi/3hosts.xml b/docs/source/tuto_smpi/3hosts.xml new file mode 100644 index 0000000000..dc058953bb --- /dev/null +++ b/docs/source/tuto_smpi/3hosts.xml @@ -0,0 +1,15 @@ + + + + + + + + + + + + + + + diff --git a/docs/source/tuto_smpi/img/3hosts.png b/docs/source/tuto_smpi/img/3hosts.png new file mode 100644 index 0000000000000000000000000000000000000000..fa21d52e3abf9de0f65bd8a840e0165eb25733c9 GIT binary patch literal 10490 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
    l`bKyamG(4B*KsREc5S9LWdLX=$qW)ZSh7 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