Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
f02e254a45630c1b90c6b79eadb093a1355a1dd0
[simgrid.git] / doc / doxygen / module-index.doc
1 /** \defgroup SD_API      SimDag
2     \brief Programming environment for DAG applications
3
4     SimDag provides some functionnalities to simulate parallel task scheduling
5     with DAGs models (Direct Acyclic Graphs).
6     The old versions of SimGrid were based on DAGs. But the DAG part (named SG)
7     was removed in SimGrid 3 because the new kernel (\ref SURF_API) was implemented. \ref SURF_API
8     was much faster and more flexible than SG and did not use DAGs.
9     SimDag is a new implementation of DAGs handling and it is built on top of \ref SURF_API.
10
11     \section SD_who Who should use this (and who shouldn't)
12
13     You should use this programming environment of the SimGrid suite if you want
14     to study algorithms and heuristics with DAGs of parallel tasks.
15     If you don't need to use DAGs for your simulation, have a look at the
16     \ref MSG_API programming environment.
17     If you want to study an existing MPI program, have a look at the
18     \ref SMPI_API one.
19     If none of those programming environments fits your needs, you may
20     consider implementing your own directly on top of \ref SURF_API (but you
21     probably want to contact us before).
22 */
23
24 /** \defgroup SMPI_API      SMPI
25     \brief Programming environment for the simulation of MPI applications
26 */
27
28
29 /**
30 @defgroup XBT_API      XBT
31 @brief The core toolbox of SimGrid, containing usefull datatypes and friends
32 */
33
34 /**
35 @defgroup TRACE_API TRACE
36 @brief Tracing mechanism and its functions.
37
38 SimGrid can trace the resource (of hosts and links) utilization using
39 any of its programming interfaces (MSG, SimDAG and SMPI). This means
40 that the tracing will register how much power is used for each host
41 and how much bandwidth is used for each link of the platform.
42
43 The idea of the tracing facilities is to give SimGrid users to
44 possibility to classify MSG and SimDAG tasks by category, tracing the
45 platform utilization (hosts and links) for each of the categories.
46 The API enables the declaration of categories and a function to
47 associate them to the tasks (MSG and SD). The tasks that are not
48 classified according to a category are not traced. If no categories
49 are specified, simulations can still be traced using a special
50 parameter in the command line (see \ref tracing for details).
51 */
52
53
54 /** \defgroup SIMIX_API      SIMIX
55     \brief POSIX-like interface for building simulation
56
57     This is a developer-level interface that should be useful only if you
58     plan to design a new interface for SimGrid.
59 */
60
61
62
63 /**
64 @defgroup SURF_API SURF
65 @brief Internal kernel of all the simulators used in SimGrid, and associated models.
66
67 SURF provides the core functionnalities to simulate a virtual
68 platform. It is very low-level and is not intended to be used by end
69 users, but rather to serve as a basis for higher-level simulators. Its
70 interfaces are not frozen (and probably never will be), and the
71 structure emphasis on performance over ease of use. This module
72 contains the platform models. If you need a model that is not encoded
73 yet, please come to the devel mailing list so that we can discuss on
74 the feasibility of your idea.
75
76 Please note that as it is not really intended for public use, this
77 module is only partially documented.
78 */
79
80
81