380_offline_performance_tools.doxy 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685
  1. /* StarPU --- Runtime system for heterogeneous multicore architectures.
  2. *
  3. * Copyright (C) 2011,2012,2015-2017 Inria
  4. * Copyright (C) 2010-2019 CNRS
  5. * Copyright (C) 2009-2011,2014-2017 Université de Bordeaux
  6. *
  7. * StarPU is free software; you can redistribute it and/or modify
  8. * it under the terms of the GNU Lesser General Public License as published by
  9. * the Free Software Foundation; either version 2.1 of the License, or (at
  10. * your option) any later version.
  11. *
  12. * StarPU is distributed in the hope that it will be useful, but
  13. * WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  15. *
  16. * See the GNU Lesser General Public License in COPYING.LGPL for more details.
  17. */
  18. /*! \page OfflinePerformanceTools Offline Performance Tools
  19. To get an idea of what is happening, a lot of performance feedback is available,
  20. detailed in this chapter. The various informations should be checked for.
  21. <ul>
  22. <li>
  23. What does the Gantt diagram look like? (see \ref CreatingAGanttDiagram)
  24. <ul>
  25. <li> If it's mostly green (tasks running in the initial context) or context specific
  26. color prevailing, then the machine is properly
  27. utilized, and perhaps the codelets are just slow. Check their performance, see
  28. \ref PerformanceOfCodelets.
  29. </li>
  30. <li> If it's mostly purple (FetchingInput), tasks keep waiting for data
  31. transfers, do you perhaps have far more communication than computation? Did
  32. you properly use CUDA streams to make sure communication can be
  33. overlapped? Did you use data-locality aware schedulers to avoid transfers as
  34. much as possible?
  35. </li>
  36. <li> If it's mostly red (Blocked), tasks keep waiting for dependencies,
  37. do you have enough parallelism? It might be a good idea to check what the DAG
  38. looks like (see \ref CreatingADAGWithGraphviz).
  39. </li>
  40. <li> If only some workers are completely red (Blocked), for some reason the
  41. scheduler didn't assign tasks to them. Perhaps the performance model is bogus,
  42. check it (see \ref PerformanceOfCodelets). Do all your codelets have a
  43. performance model? When some of them don't, the schedulers switches to a
  44. greedy algorithm which thus performs badly.
  45. </li>
  46. </ul>
  47. </li>
  48. </ul>
  49. You can also use the Temanejo task debugger (see \ref UsingTheTemanejoTaskDebugger) to
  50. visualize the task graph more easily.
  51. \section Off-linePerformanceFeedback Off-line Performance Feedback
  52. \subsection GeneratingTracesWithFxT Generating Traces With FxT
  53. StarPU can use the FxT library (see
  54. https://savannah.nongnu.org/projects/fkt/) to generate traces
  55. with a limited runtime overhead.
  56. You can either get a tarball:
  57. \verbatim
  58. $ wget http://download.savannah.gnu.org/releases/fkt/fxt-0.2.11.tar.gz
  59. \endverbatim
  60. or use the FxT library from CVS (autotools are required):
  61. \verbatim
  62. $ cvs -d :pserver:anonymous\@cvs.sv.gnu.org:/sources/fkt co FxT
  63. $ ./bootstrap
  64. \endverbatim
  65. Compiling and installing the FxT library in the <c>$FXTDIR</c> path is
  66. done following the standard procedure:
  67. \verbatim
  68. $ ./configure --prefix=$FXTDIR
  69. $ make
  70. $ make install
  71. \endverbatim
  72. In order to have StarPU to generate traces, StarPU should be configured with
  73. the option \ref with-fxt "--with-fxt" :
  74. \verbatim
  75. $ ./configure --with-fxt=$FXTDIR
  76. \endverbatim
  77. Or you can simply point the <c>PKG_CONFIG_PATH</c> to
  78. <c>$FXTDIR/lib/pkgconfig</c> and pass
  79. \ref with-fxt "--with-fxt" to <c>configure</c>
  80. When FxT is enabled, a trace is generated when StarPU is terminated by calling
  81. starpu_shutdown(). The trace is a binary file whose name has the form
  82. <c>prof_file_XXX_YYY</c> where <c>XXX</c> is the user name, and
  83. <c>YYY</c> is the pid of the process that used StarPU. This file is saved in the
  84. <c>/tmp/</c> directory by default, or by the directory specified by
  85. the environment variable \ref STARPU_FXT_PREFIX.
  86. The additional \c configure option \ref enable-fxt-lock "--enable-fxt-lock" can
  87. be used to generate trace events which describes the locks behaviour during
  88. the execution. It is however very heavy and should not be used unless debugging
  89. StarPU's internal locking.
  90. The environment variable \ref STARPU_FXT_TRACE can be set to 0 to disable the
  91. generation of the <c>prof_file_XXX_YYY</c> file.
  92. When the FxT trace file <c>prof_file_something</c> has been generated,
  93. it is possible to generate different trace formats by calling:
  94. \verbatim
  95. $ starpu_fxt_tool -i /tmp/prof_file_something
  96. \endverbatim
  97. Or alternatively, setting the environment variable \ref STARPU_GENERATE_TRACE
  98. to <c>1</c> before application execution will make StarPU do it automatically at
  99. application shutdown.
  100. One can also set the environment variable \ref
  101. STARPU_GENERATE_TRACE_OPTIONS to specify options, see
  102. <c>starpu_fxt_tool --help</c>, for example:
  103. \verbatim
  104. $ export STARPU_GENERATE_TRACE=1
  105. $ export STARPU_GENERATE_TRACE_OPTIONS="-no-acquire"
  106. \endverbatim
  107. When running a MPI application, \ref STARPU_GENERATE_TRACE will not
  108. work as expected (each node will try to generate trace files, thus
  109. mixing outputs...), you have to collect the trace files from the MPI
  110. nodes, and specify them all on the command <c>starpu_fxt_tool</c>, for
  111. instance:
  112. \verbatim
  113. $ starpu_fxt_tool -i /tmp/prof_file_something*
  114. \endverbatim
  115. By default, the generated trace contains all informations. To reduce
  116. the trace size, various <c>-no-foo</c> options can be passed to
  117. <c>starpu_fxt_tool</c>, see <c>starpu_fxt_tool --help</c> .
  118. \subsubsection CreatingAGanttDiagram Creating a Gantt Diagram
  119. One of the generated files is a trace in the Paje format. The file,
  120. located in the current directory, is named <c>paje.trace</c>. It can
  121. be viewed with ViTE (http://vite.gforge.inria.fr/) a trace
  122. visualizing open-source tool. To open the file <c>paje.trace</c> with
  123. ViTE, use the following command:
  124. \verbatim
  125. $ vite paje.trace
  126. \endverbatim
  127. Tasks can be assigned a name (instead of the default \c unknown) by
  128. filling the optional starpu_codelet::name, or assigning them a
  129. performance model. The name can also be set with the field
  130. starpu_task::name or by using \ref STARPU_NAME when calling
  131. starpu_task_insert().
  132. Tasks are assigned default colors based on the worker which executed
  133. them (green for CPUs, yellow/orange/red for CUDAs, blue for OpenCLs,
  134. red for MICs, ...). To use a different color for every type of task,
  135. one can specify the option <c>-c</c> to <c>starpu_fxt_tool</c> or in
  136. \ref STARPU_GENERATE_TRACE_OPTIONS. Tasks can also be given a specific
  137. color by setting the field starpu_codelet::color or the
  138. starpu_task::color. Colors are expressed with the following format
  139. \c 0xRRGGBB (e.g \c 0xFF0000 for red). See
  140. <c>basic_examples/task_insert_color</c> for examples on how to assign
  141. colors.
  142. To identify tasks precisely, the application can also set the field
  143. starpu_task::tag_id or setting \ref STARPU_TAG_ONLY when calling
  144. starpu_task_insert(). The value of the tag will then show up in the
  145. trace.
  146. One can also introduce user-defined events in the diagram thanks to the
  147. starpu_fxt_trace_user_event_string() function.
  148. One can also set the iteration number, by just calling starpu_iteration_push()
  149. at the beginning of submission loops and starpu_iteration_pop() at the end of
  150. submission loops. These iteration numbers will show up in traces for all tasks
  151. submitted from there.
  152. Coordinates can also be given to data with the starpu_data_set_coordinates() or
  153. starpu_data_set_coordinates_array() function. In the trace, tasks will then be
  154. assigned the coordinates of the first data they write to.
  155. Traces can also be inspected by hand by using the tool <c>fxt_print</c>, for instance:
  156. \verbatim
  157. $ fxt_print -o -f /tmp/prof_file_something
  158. \endverbatim
  159. Timings are in nanoseconds (while timings as seen in ViTE are in milliseconds).
  160. \subsubsection CreatingADAGWithGraphviz Creating a DAG With Graphviz
  161. Another generated trace file is a task graph described using the DOT
  162. language. The file, created in the current directory, is named
  163. <c>dag.dot</c> file in the current directory.
  164. It is possible to get a graphical output of the graph by using the
  165. <c>graphviz</c> library:
  166. \verbatim
  167. $ dot -Tpdf dag.dot -o output.pdf
  168. \endverbatim
  169. \subsubsection TraceTaskDetails Getting Task Details
  170. Another generated trace file gives details on the executed tasks. The
  171. file, created in the current directory, is named <c>tasks.rec</c>. This file
  172. is in the recutils format, i.e. <c>Field: value</c> lines, and empty lines to
  173. separate each task. This can be used as a convenient input for various ad-hoc
  174. analysis tools. By default it only contains information about the actual
  175. execution. Performance models can be obtained by running
  176. <c>starpu_tasks_rec_complete</c> on it:
  177. \verbatim
  178. $ starpu_tasks_rec_complete tasks.rec tasks2.rec
  179. \endverbatim
  180. which will add <c>EstimatedTime</c> lines which contain the performance
  181. model-estimated time (in µs) for each worker starting from 0. Since it needs
  182. the performance models, it needs to be run the same way as the application
  183. execution, or at least with <c>STARPU_HOSTNAME</c> set to the hostname of the
  184. machine used for execution, to get the performance models of that machine.
  185. Another possibility is to obtain the performance models as an auxiliary <c>perfmodel.rec</c> file, by using the <c>starpu_perfmodel_recdump</c> utility:
  186. \verbatim
  187. $ starpu_perfmodel_recdump tasks.rec -o perfmodel.rec
  188. \endverbatim
  189. \subsubsection MonitoringActivity Monitoring Activity
  190. Another generated trace file is an activity trace. The file, created
  191. in the current directory, is named <c>activity.data</c>. A profile of
  192. the application showing the activity of StarPU during the execution of
  193. the program can be generated:
  194. \verbatim
  195. $ starpu_workers_activity activity.data
  196. \endverbatim
  197. This will create a file named <c>activity.eps</c> in the current directory.
  198. This picture is composed of two parts.
  199. The first part shows the activity of the different workers. The green sections
  200. indicate which proportion of the time was spent executed kernels on the
  201. processing unit. The red sections indicate the proportion of time spent in
  202. StartPU: an important overhead may indicate that the granularity may be too
  203. low, and that bigger tasks may be appropriate to use the processing unit more
  204. efficiently. The black sections indicate that the processing unit was blocked
  205. because there was no task to process: this may indicate a lack of parallelism
  206. which may be alleviated by creating more tasks when it is possible.
  207. The second part of the picture <c>activity.eps</c> is a graph showing the
  208. evolution of the number of tasks available in the system during the execution.
  209. Ready tasks are shown in black, and tasks that are submitted but not
  210. schedulable yet are shown in grey.
  211. \subsubsection Animation Getting Modular Schedular Animation
  212. When using modular schedulers (i.e. schedulers which use a modular architecture,
  213. and whose name start with "modular-"), the call to
  214. <c>starpu_fxt_tool</c> will also produce a <c>trace.html</c> file
  215. which can be viewed in a javascript-enabled web browser. It shows the
  216. flow of tasks between the components of the modular scheduler.
  217. \subsection LimitingScopeTrace Limiting The Scope Of The Trace
  218. For computing statistics, it is useful to limit the trace to a given portion of
  219. the time of the whole execution. This can be achieved by calling
  220. \code{.c}
  221. starpu_fxt_autostart_profiling(0)
  222. \endcode
  223. before calling starpu_init(), to
  224. prevent tracing from starting immediately. Then
  225. \code{.c}
  226. starpu_fxt_start_profiling();
  227. \endcode
  228. and
  229. \code{.c}
  230. starpu_fxt_stop_profiling();
  231. \endcode
  232. can be used around the portion of code to be traced. This will show up as marks
  233. in the trace, and states of workers will only show up for that portion.
  234. \section PerformanceOfCodelets Performance Of Codelets
  235. The performance model of codelets (see \ref PerformanceModelExample)
  236. can be examined by using the tool <c>starpu_perfmodel_display</c>:
  237. \verbatim
  238. $ starpu_perfmodel_display -l
  239. file: <malloc_pinned.hannibal>
  240. file: <starpu_slu_lu_model_21.hannibal>
  241. file: <starpu_slu_lu_model_11.hannibal>
  242. file: <starpu_slu_lu_model_22.hannibal>
  243. file: <starpu_slu_lu_model_12.hannibal>
  244. \endverbatim
  245. Here, the codelets of the example <c>lu</c> are available. We can examine the
  246. performance of the kernel <c>22</c> (in micro-seconds), which is history-based:
  247. \verbatim
  248. $ starpu_perfmodel_display -s starpu_slu_lu_model_22
  249. performance model for cpu
  250. # hash size mean dev n
  251. 57618ab0 19660800 2.851069e+05 1.829369e+04 109
  252. performance model for cuda_0
  253. # hash size mean dev n
  254. 57618ab0 19660800 1.164144e+04 1.556094e+01 315
  255. performance model for cuda_1
  256. # hash size mean dev n
  257. 57618ab0 19660800 1.164271e+04 1.330628e+01 360
  258. performance model for cuda_2
  259. # hash size mean dev n
  260. 57618ab0 19660800 1.166730e+04 3.390395e+02 456
  261. \endverbatim
  262. We can see that for the given size, over a sample of a few hundreds of
  263. execution, the GPUs are about 20 times faster than the CPUs (numbers are in
  264. us). The standard deviation is extremely low for the GPUs, and less than 10% for
  265. CPUs.
  266. This tool can also be used for regression-based performance models. It will then
  267. display the regression formula, and in the case of non-linear regression, the
  268. same performance log as for history-based performance models:
  269. \verbatim
  270. $ starpu_perfmodel_display -s non_linear_memset_regression_based
  271. performance model for cpu_impl_0
  272. Regression : #sample = 1400
  273. Linear: y = alpha size ^ beta
  274. alpha = 1.335973e-03
  275. beta = 8.024020e-01
  276. Non-Linear: y = a size ^b + c
  277. a = 5.429195e-04
  278. b = 8.654899e-01
  279. c = 9.009313e-01
  280. # hash size mean stddev n
  281. a3d3725e 4096 4.763200e+00 7.650928e-01 100
  282. 870a30aa 8192 1.827970e+00 2.037181e-01 100
  283. 48e988e9 16384 2.652800e+00 1.876459e-01 100
  284. 961e65d2 32768 4.255530e+00 3.518025e-01 100
  285. ...
  286. \endverbatim
  287. The same can also be achieved by using StarPU's library API, see
  288. \ref API_Performance_Model and notably the function
  289. starpu_perfmodel_load_symbol(). The source code of the tool
  290. <c>starpu_perfmodel_display</c> can be a useful example.
  291. The tool <c>starpu_perfmodel_plot</c> can be used to draw performance
  292. models. It writes a <c>.gp</c> file in the current directory, to be
  293. run with the tool <c>gnuplot</c>, which shows the corresponding curve.
  294. \image html starpu_non_linear_memset_regression_based.png
  295. \image latex starpu_non_linear_memset_regression_based.eps "" width=\textwidth
  296. When the field starpu_task::flops is set (or \ref STARPU_FLOPS is passed to
  297. starpu_task_insert()), <c>starpu_perfmodel_plot</c> can directly draw a GFlops
  298. curve, by simply adding the <c>-f</c> option:
  299. \verbatim
  300. $ starpu_perfmodel_plot -f -s chol_model_11
  301. \endverbatim
  302. This will however disable displaying the regression model, for which we can not
  303. compute GFlops.
  304. \image html starpu_chol_model_11_type.png
  305. \image latex starpu_chol_model_11_type.eps "" width=\textwidth
  306. When the FxT trace file <c>prof_file_something</c> has been generated, it is possible to
  307. get a profiling of each codelet by calling:
  308. \verbatim
  309. $ starpu_fxt_tool -i /tmp/prof_file_something
  310. $ starpu_codelet_profile distrib.data codelet_name
  311. \endverbatim
  312. This will create profiling data files, and a <c>distrib.data.gp</c> file in the current
  313. directory, which draws the distribution of codelet time over the application
  314. execution, according to data input size.
  315. \image html distrib_data.png
  316. \image latex distrib_data.eps "" width=\textwidth
  317. This is also available in the tool <c>starpu_perfmodel_plot</c>, by passing it
  318. the fxt trace:
  319. \verbatim
  320. $ starpu_perfmodel_plot -s non_linear_memset_regression_based -i /tmp/prof_file_foo_0
  321. \endverbatim
  322. It will produce a <c>.gp</c> file which contains both the performance model
  323. curves, and the profiling measurements.
  324. \image html starpu_non_linear_memset_regression_based_2.png
  325. \image latex starpu_non_linear_memset_regression_based_2.eps "" width=\textwidth
  326. If you have the statistical tool <c>R</c> installed, you can additionally use
  327. \verbatim
  328. $ starpu_codelet_histo_profile distrib.data
  329. \endverbatim
  330. Which will create one <c>.pdf</c> file per codelet and per input size, showing a
  331. histogram of the codelet execution time distribution.
  332. \image html distrib_data_histo.png
  333. \image latex distrib_data_histo.eps "" width=\textwidth
  334. \section TraceStatistics Trace Statistics
  335. More than just codelet performance, it is interesting to get statistics over all
  336. kinds of StarPU states (allocations, data transfers, etc.). This is particularly
  337. useful to check what may have gone wrong in the accurracy of the simgrid
  338. simulation.
  339. This requires the <c>R</c> statistical tool, with the <c>plyr</c>,
  340. <c>ggplot2</c> and <c>data.table</c> packages. If your system
  341. distribution does not have packages for these, one can fetch them from
  342. <c>CRAN</c>:
  343. \verbatim
  344. $ R
  345. > install.packages("plyr")
  346. > install.packages("ggplot2")
  347. > install.packages("data.table")
  348. > install.packages("knitr")
  349. \endverbatim
  350. The <c>pj_dump</c> tool from <c>pajeng</c> is also needed (see
  351. https://github.com/schnorr/pajeng)
  352. One can then get textual or <c>.csv</c> statistics over the trace states:
  353. \verbatim
  354. $ starpu_paje_state_stats -v native.trace simgrid.trace
  355. "Value" "Events_native.csv" "Duration_native.csv" "Events_simgrid.csv" "Duration_simgrid.csv"
  356. "Callback" 220 0.075978 220 0
  357. "chol_model_11" 10 565.176 10 572.8695
  358. "chol_model_21" 45 9184.828 45 9170.719
  359. "chol_model_22" 165 64712.07 165 64299.203
  360. $ starpu_paje_state_stats native.trace simgrid.trace
  361. \endverbatim
  362. An other way to get statistics of StarPU states (without installing <c>R</c> and
  363. <c>pj_dump</c>) is to use the <c>starpu_trace_state_stats.py</c> script which parses the
  364. generated <c>trace.rec</c> file instead of the <c>paje.trace</c> file. The output is similar
  365. to the previous script but it doesn't need any dependencies.
  366. The different prefixes used in <c>trace.rec</c> are:
  367. \verbatim
  368. E: Event type
  369. N: Event name
  370. C: Event category
  371. W: Worker ID
  372. T: Thread ID
  373. S: Start time
  374. \endverbatim
  375. Here's an example on how to use it:
  376. \verbatim
  377. $ python starpu_trace_state_stats.py trace.rec | column -t -s ","
  378. "Name" "Count" "Type" "Duration"
  379. "Callback" 220 Runtime 0.075978
  380. "chol_model_11" 10 Task 565.176
  381. "chol_model_21" 45 Task 9184.828
  382. "chol_model_22" 165 Task 64712.07
  383. \endverbatim
  384. <c>starpu_trace_state_stats.py</c> can also be used to compute the different
  385. efficiencies. Refer to the usage description to show some examples.
  386. And one can plot histograms of execution times, of several states for instance:
  387. \verbatim
  388. $ starpu_paje_draw_histogram -n chol_model_11,chol_model_21,chol_model_22 native.trace simgrid.trace
  389. \endverbatim
  390. and see the resulting pdf file:
  391. \image html paje_draw_histogram.png
  392. \image latex paje_draw_histogram.eps "" width=\textwidth
  393. A quick statistical report can be generated by using:
  394. \verbatim
  395. $ starpu_paje_summary native.trace simgrid.trace
  396. \endverbatim
  397. it includes gantt charts, execution summaries, as well as state duration charts
  398. and time distribution histograms.
  399. Other external Paje analysis tools can be used on these traces, one just needs
  400. to sort the traces by timestamp order (which not guaranteed to make recording
  401. more efficient):
  402. \verbatim
  403. $ starpu_paje_sort paje.trace
  404. \endverbatim
  405. \section TheoreticalLowerBoundOnExecutionTime Theoretical Lower Bound On Execution Time
  406. StarPU can record a trace of what tasks are needed to complete the
  407. application, and then, by using a linear system, provide a theoretical lower
  408. bound of the execution time (i.e. with an ideal scheduling).
  409. The computed bound is not really correct when not taking into account
  410. dependencies, but for an application which have enough parallelism, it is very
  411. near to the bound computed with dependencies enabled (which takes a huge lot
  412. more time to compute), and thus provides a good-enough estimation of the ideal
  413. execution time.
  414. \ref TheoreticalLowerBoundOnExecutionTimeExample provides an example on how to
  415. use this.
  416. \section TheoreticalLowerBoundOnExecutionTimeExample Theoretical Lower Bound On Execution Time Example
  417. For kernels with history-based performance models (and provided that
  418. they are completely calibrated), StarPU can very easily provide a
  419. theoretical lower bound for the execution time of a whole set of
  420. tasks. See for instance <c>examples/lu/lu_example.c</c>: before
  421. submitting tasks, call the function starpu_bound_start(), and after
  422. complete execution, call starpu_bound_stop().
  423. starpu_bound_print_lp() or starpu_bound_print_mps() can then be used
  424. to output a Linear Programming problem corresponding to the schedule
  425. of your tasks. Run it through <c>lp_solve</c> or any other linear
  426. programming solver, and that will give you a lower bound for the total
  427. execution time of your tasks. If StarPU was compiled with the library
  428. <c>glpk</c> installed, starpu_bound_compute() can be used to solve it
  429. immediately and get the optimized minimum, in ms. Its parameter
  430. <c>integer</c> allows to decide whether integer resolution should be
  431. computed and returned
  432. The <c>deps</c> parameter tells StarPU whether to take tasks, implicit
  433. data, and tag dependencies into account. Tags released in a callback
  434. or similar are not taken into account, only tags associated with a task are.
  435. It must be understood that the linear programming
  436. problem size is quadratic with the number of tasks and thus the time to solve it
  437. will be very long, it could be minutes for just a few dozen tasks. You should
  438. probably use <c>lp_solve -timeout 1 test.pl -wmps test.mps</c> to convert the
  439. problem to MPS format and then use a better solver, <c>glpsol</c> might be
  440. better than <c>lp_solve</c> for instance (the <c>--pcost</c> option may be
  441. useful), but sometimes doesn't manage to converge. <c>cbc</c> might look
  442. slower, but it is parallel. For <c>lp_solve</c>, be sure to try at least all the
  443. <c>-B</c> options. For instance, we often just use <c>lp_solve -cc -B1 -Bb
  444. -Bg -Bp -Bf -Br -BG -Bd -Bs -BB -Bo -Bc -Bi</c> , and the <c>-gr</c> option can
  445. also be quite useful. The resulting schedule can be observed by using
  446. the tool <c>starpu_lp2paje</c>, which converts it into the Paje
  447. format.
  448. Data transfer time can only be taken into account when <c>deps</c> is set. Only
  449. data transfers inferred from implicit data dependencies between tasks are taken
  450. into account. Other data transfers are assumed to be completely overlapped.
  451. Setting <c>deps</c> to 0 will only take into account the actual computations
  452. on processing units. It however still properly takes into account the varying
  453. performances of kernels and processing units, which is quite more accurate than
  454. just comparing StarPU performances with the fastest of the kernels being used.
  455. The <c>prio</c> parameter tells StarPU whether to simulate taking into account
  456. the priorities as the StarPU scheduler would, i.e. schedule prioritized
  457. tasks before less prioritized tasks, to check to which extend this results
  458. to a less optimal solution. This increases even more computation time.
  459. \section MemoryFeedback Memory Feedback
  460. It is possible to enable memory statistics. To do so, you need to pass
  461. the option \ref enable-memory-stats "--enable-memory-stats" when running <c>configure</c>. It is then
  462. possible to call the function starpu_data_display_memory_stats() to
  463. display statistics about the current data handles registered within StarPU.
  464. Moreover, statistics will be displayed at the end of the execution on
  465. data handles which have not been cleared out. This can be disabled by
  466. setting the environment variable \ref STARPU_MEMORY_STATS to <c>0</c>.
  467. For example, if you do not unregister data at the end of the complex
  468. example, you will get something similar to:
  469. \verbatim
  470. $ STARPU_MEMORY_STATS=0 ./examples/interface/complex
  471. Complex[0] = 45.00 + 12.00 i
  472. Complex[0] = 78.00 + 78.00 i
  473. Complex[0] = 45.00 + 12.00 i
  474. Complex[0] = 45.00 + 12.00 i
  475. \endverbatim
  476. \verbatim
  477. $ STARPU_MEMORY_STATS=1 ./examples/interface/complex
  478. Complex[0] = 45.00 + 12.00 i
  479. Complex[0] = 78.00 + 78.00 i
  480. Complex[0] = 45.00 + 12.00 i
  481. Complex[0] = 45.00 + 12.00 i
  482. #---------------------
  483. Memory stats:
  484. #-------
  485. Data on Node #3
  486. #-----
  487. Data : 0x553ff40
  488. Size : 16
  489. #--
  490. Data access stats
  491. /!\ Work Underway
  492. Node #0
  493. Direct access : 4
  494. Loaded (Owner) : 0
  495. Loaded (Shared) : 0
  496. Invalidated (was Owner) : 0
  497. Node #3
  498. Direct access : 0
  499. Loaded (Owner) : 0
  500. Loaded (Shared) : 1
  501. Invalidated (was Owner) : 0
  502. #-----
  503. Data : 0x5544710
  504. Size : 16
  505. #--
  506. Data access stats
  507. /!\ Work Underway
  508. Node #0
  509. Direct access : 2
  510. Loaded (Owner) : 0
  511. Loaded (Shared) : 1
  512. Invalidated (was Owner) : 1
  513. Node #3
  514. Direct access : 0
  515. Loaded (Owner) : 1
  516. Loaded (Shared) : 0
  517. Invalidated (was Owner) : 0
  518. \endverbatim
  519. \section DataStatistics Data Statistics
  520. Different data statistics can be displayed at the end of the execution
  521. of the application. To enable them, you need to define the environment
  522. variable \ref STARPU_ENABLE_STATS. When calling
  523. starpu_shutdown() various statistics will be displayed,
  524. execution, MSI cache statistics, allocation cache statistics, and data
  525. transfer statistics. The display can be disabled by setting the
  526. environment variable \ref STARPU_STATS to <c>0</c>.
  527. \verbatim
  528. $ ./examples/cholesky/cholesky_tag
  529. Computation took (in ms)
  530. 518.16
  531. Synthetic GFlops : 44.21
  532. #---------------------
  533. MSI cache stats :
  534. TOTAL MSI stats hit 1622 (66.23 %) miss 827 (33.77 %)
  535. ...
  536. \endverbatim
  537. \verbatim
  538. $ STARPU_STATS=0 ./examples/cholesky/cholesky_tag
  539. Computation took (in ms)
  540. 518.16
  541. Synthetic GFlops : 44.21
  542. \endverbatim
  543. // TODO: data transfer stats are similar to the ones displayed when
  544. // setting STARPU_BUS_STATS
  545. */