소스 검색

Move starpu_fxt_data_trace to offline tracing chapter

Samuel Thibault 5 년 전
부모
커밋
4c8e0e4239

+ 2 - 0
doc/doxygen/chapters/301_tasks.doxy

@@ -31,6 +31,8 @@ checked if bad performance are observed. To get a grasp at the scalability
 possibility according to task size, one can run
 possibility according to task size, one can run
 <c>tests/microbenchs/tasks_size_overhead.sh</c> which draws curves of the
 <c>tests/microbenchs/tasks_size_overhead.sh</c> which draws curves of the
 speedup of independent tasks of very small sizes.
 speedup of independent tasks of very small sizes.
+To determine what task size your application is actually using, one can use
+<c>starpu_fxt_data_trace</c>, see \ref DataTrace .
 
 
 The choice of scheduler also has impact over the overhead: for instance, the
 The choice of scheduler also has impact over the overhead: for instance, the
  scheduler <c>dmda</c> takes time to make a decision, while <c>eager</c> does
  scheduler <c>dmda</c> takes time to make a decision, while <c>eager</c> does

+ 0 - 14
doc/doxygen/chapters/370_online_performance_tools.doxy

@@ -463,20 +463,6 @@ The application can also request an on-the-fly XML report of the performance
 model, by calling starpu_perfmodel_dump_xml() to print the report to a
 model, by calling starpu_perfmodel_dump_xml() to print the report to a
 <c>FILE*</c>.
 <c>FILE*</c>.
 
 
-\section DataTrace Data trace and tasks length
-It is possible to get statistics about tasks length and data size by using :
-\verbatim
-$ starpu_fxt_data_trace filename [codelet1 codelet2 ... codeletn]
-\endverbatim
-Where filename is the FxT trace file and codeletX the names of the codelets you
-want to profile (if no names are specified, <c>starpu_fxt_data_trace</c> will profile them all).
-This will create a file, <c>data_trace.gp</c> which
-can be executed to get a <c>.eps</c> image of these results. On the image, each point represents a
-task, and each color corresponds to a codelet.
-
-\image html data_trace.png
-\image latex data_trace.eps "" width=\textwidth
-
 \section Performance Monitoring Counters
 \section Performance Monitoring Counters
 
 
 This section presents the StarPU performance monitoring framework. It summarizes the objectives of the framework. It then introduces the entities involved in the framework. It presents the API of the framework, as well as some implementation details. It exposes the typical sequence of operations to plug an external tool to monitor a performance counter of StarPU.
 This section presents the StarPU performance monitoring framework. It summarizes the objectives of the framework. It then introduces the entities involved in the framework. It presents the API of the framework, as well as some implementation details. It exposes the typical sequence of operations to plug an external tool to monitor a performance counter of StarPU.

+ 15 - 0
doc/doxygen/chapters/380_offline_performance_tools.doxy

@@ -455,6 +455,21 @@ histogram of the codelet execution time distribution.
 \image html distrib_data_histo.png
 \image html distrib_data_histo.png
 \image latex distrib_data_histo.eps "" width=\textwidth
 \image latex distrib_data_histo.eps "" width=\textwidth
 
 
+\section DataTrace Data trace and tasks length
+
+It is possible to get statistics about tasks length and data size by using :
+\verbatim
+$ starpu_fxt_data_trace filename [codelet1 codelet2 ... codeletn]
+\endverbatim
+Where filename is the FxT trace file and codeletX the names of the codelets you
+want to profile (if no names are specified, <c>starpu_fxt_data_trace</c> will profile them all).
+This will create a file, <c>data_trace.gp</c> which
+can be executed to get a <c>.eps</c> image of these results. On the image, each point represents a
+task, and each color corresponds to a codelet.
+
+\image html data_trace.png
+\image latex data_trace.eps "" width=\textwidth
+
 \section TraceStatistics Trace Statistics
 \section TraceStatistics Trace Statistics
 
 
 More than just codelet performance, it is interesting to get statistics over all
 More than just codelet performance, it is interesting to get statistics over all