Eclipse PLugin

doc/doxygen/chapters/380_offline_performance_tools.doxy

@@ -841,6 +841,51 @@ An example of visualization follows:
 \image html starvz_visu_r.png
 \image latex starvz_visu_r.pdf "" width=\textwidth
 
+\section EclipsePlugin Eclipse Plugin
+The StarPU Eclipse Plugin provides the ability to generate the different traces directly from the Eclipse IDE.
+After executing the StarPU application (C/C++), one can use the StarPU plugin to generate and visualise the task graph of the application. The StarPU plugin eclipse is either available through the icons in the upper toolbar, or from the dropdown menu StarPU.
+
+\image html plugin_eclipse.png
+\image latex plugin_eclipse.pdf "" width=\textwidth
+
+To start, one first need to run the <c>StarPU FxT tool</c>, either through the FxT icon of the toolbar, or from the menu StarPU. 
+
+To generate traces from the application, it is necessary to set \ref STARPU_FXT_TRACE to 1 and build StarPU with FxT. 
+When FxT is enabled, a trace is generated when StarPU is terminated by calling starpu_shutdown(). 
+
+\image html fxt_tool.png
+\image latex fxt_tool.pdf "" width=\textwidth
+
+Setting the environment variable \ref STARPU_FXT_TRACE to 1 before application execution will make StarPU generate the prof_file_XXX_YYY file automatically at application shutdown.
+When the FxT trace file prof_file_something has been generated, it is possible to generate different trace formats by running the first command of StarPU menu, or the FXT icon in the toolbar. A message dialog box is displayed to confirm the generation of the different traces.
+
+\image html generated_traces.png
+\image latex generated_traces.pdf "" width=\textwidth
+
+One of the generated files is a trace in the <c>paje format</c>. The file is named \ref paje.trace. It can be viewed with ViTE, which is a trace explorer. To open and visualise the file paje.trace with ViTE, one can select the second command of the StarPU menu, which is named <c>Generate Paje Trace</c>, or click on the second icon named <c>Trace</c> in the toolbar of eclipse.
+
+\image html paje_trace.png
+\image latex paje_trace.pdf "" width=\textwidth
+
+\image html vite.png
+\image latex vite.pdf "" width=\textwidth
+
+Another generated trace file is a task graph described using the DOT language. It is possible to get a graphical output of the graph by calling the <c>graphviz library</c>. To do this, one can click on the third command of StarPU menu. A task graph of the application in (.PNG) format is then generated.
+\image html run_task_graph.png
+\image latex run_task_graph.pdf "" width=\textwidth
+
+\image html task_graph.png
+\image latex task_graph.pdf "" width=\textwidth
+In StarPU eclipse plugin, one can display the graph task directly from eclipse, or through a web browser. To do this, there is another command named <c> Generate SVG graph</c> in the StarPU menu or HGraph in the toolbar of eclipse.     
+
+From the HTML file, you can see the graph task, and by clicking on a task name, it will open the C file in which the task submission was called.
+
+\image html svg_graph.png
+\image latex svg_graph.pdf "" width=\textwidth
+
+\image html hgraph.png
+\image latex hgraph.pdf "" width=\textwidth
+
 \section MemoryFeedback Memory Feedback
 
 It is possible to enable memory statistics. To do so, you need to pass