Add new entry in Release_Notes.

[simgrid.git] / doc / doxygen / outcomes_vizu.doc

diff --git a/doc/doxygen/outcomes_vizu.doc b/doc/doxygen/outcomes_vizu.doc
index 351a7b2e6370e92b526c3839c5a3e9ce90077282..b4fb66faf49419b524eeaef47f5a388f0a0b5e04 100644 (file)
--- a/doc/doxygen/outcomes_vizu.doc
+++ b/doc/doxygen/outcomes_vizu.doc
@@ -1,8 +1,27 @@
+/**
+@defgroup TRACE_API TRACING
+@brief Gather data about your simulation for later analysis
+
+SimGrid can trace the resource (of hosts and links) utilization using
+any of its programming interfaces (S4U, SimDAG and SMPI). This means
+that the tracing will register how much power is used for each host
+and how much bandwidth is used for each link of the platform.
+
+The idea of the tracing facilities is to give SimGrid users to
+possibility to classify S4U and SimDAG tasks by category, tracing the
+platform utilization (hosts and links) for each of the categories.
+The API enables the declaration of categories and a function to
+associate them to the tasks (S4U and SD). The tasks that are not
+classified according to a category are not traced. If no categories
+are specified, simulations can still be traced using a special
+parameter in the command line (see @ref outcomes_vizu for details).
+*/
+

 /*! @page outcomes_vizu Visualization and Statistical Analysis
 
 SimGrid comes with an extensive support to trace and register what
 happens during the simulation, so that it can be either visualized or
 /*! @page outcomes_vizu Visualization and Statistical Analysis
 
 SimGrid comes with an extensive support to trace and register what
 happens during the simulation, so that it can be either visualized or

-statistically analysed after the simulation. 
+statistically analysed after the simulation.

 
 This tracing is widely used to observe and understand the behavior of
 parallel applications and distributed algorithms. Usually, this is
 
 This tracing is widely used to observe and understand the behavior of
 parallel applications and distributed algorithms. Usually, this is


@@ -335,7 +354,7 @@ you should use to analyze your simulator.
 @li I want to trace the resource utilization of all hosts
 and links of the platform, and my simulator <b>does not</b> use
 the tracing API. For that, you can run a uncategorized trace
 @li I want to trace the resource utilization of all hosts
 and links of the platform, and my simulator <b>does not</b> use
 the tracing API. For that, you can run a uncategorized trace

-with the following parameters (it will work with <b>any</b> Simgrid
+with the following parameters (it will work with <b>any</b> SimGrid

 simulator):
 @verbatim
 ./your_simulator @
 simulator):
 @verbatim
 ./your_simulator @


@@ -438,7 +457,7 @@ several options to analyze this trace file:
   SimGrid User::Visualization 101 tutorial.
 
 - Ask for help on the <a
   SimGrid User::Visualization 101 tutorial.
 
 - Ask for help on the <a

-  href="mailto:simgrid-user@lists.gforge.inria.fr">simgrid-user@lists.gforge.inria.fr</a>
+  href="mailto:simgrid-community@inria.fr">simgrid-community@inria.fr</a>

   mailing list, giving us a detailed explanation on what your
   simulator does and what kind of information you want to trace. You
   can also check the <a
   mailing list, giving us a detailed explanation on what your
   simulator does and what kind of information you want to trace. You
   can also check the <a