Browse Source

rename the starpu_regression_display tool into starpu_perfmodel_plot, document it a bit

Samuel Thibault 14 years ago
parent
commit
2fc03f4d58
3 changed files with 21 additions and 14 deletions
  1. 17 2
      doc/starpu.texi
  2. 4 12
      tools/Makefile.am
  3. 0 0
      tools/starpu_perfmodel_plot.c

+ 17 - 2
doc/starpu.texi

@@ -1245,7 +1245,11 @@ it as an estimation. History is done per task size, by using a hash of the input
 and ouput sizes as an index.
 and ouput sizes as an index.
 It will also save it in @code{~/.starpu/sampling/codelets}
 It will also save it in @code{~/.starpu/sampling/codelets}
 for further executions, and can be observed by using the
 for further executions, and can be observed by using the
-@code{starpu_perfmodel_display} command. The models are indexed by machine name. To share the models between machines (e.g. for a homogeneous cluster), use @code{export STARPU_HOSTNAME=some_global_name}.  The following is a small code example.
+@code{starpu_perfmodel_display} command, or drawn by using
+the @code{starpu_perfmodel_plot}.  The models are indexed by machine name. To
+share the models between machines (e.g. for a homogeneous cluster), use
+@code{export STARPU_HOSTNAME=some_global_name}.  The following is a small code
+example.
 
 
 If e.g. the code is recompiled with other compilation options, or several
 If e.g. the code is recompiled with other compilation options, or several
 variants of the code are used, the symbol string should be changed to reflect
 variants of the code are used, the symbol string should be changed to reflect
@@ -1641,7 +1645,9 @@ to choose the performance model to be displayed. The result looks like:
 $ starpu_perfmodel_display -s starpu_dlu_lu_model_22
 $ starpu_perfmodel_display -s starpu_dlu_lu_model_22
 performance model for cpu
 performance model for cpu
 # hash		size		mean		dev		n
 # hash		size		mean		dev		n
-5c6c3401	1572864        	1.216300e+04   	2.277778e+03   	1240
+880805ba	98304          	2.731309e+02   	6.010210e+01   	1240
+b50b6605	393216         	1.469926e+03   	1.088828e+02   	1240
+5c6c3401	1572864        	1.125983e+04   	3.265296e+03   	1240
 @end example
 @end example
 
 
 Which shows that for the LU 22 kernel with a 1.5MiB matrix, the average
 Which shows that for the LU 22 kernel with a 1.5MiB matrix, the average
@@ -1649,6 +1655,15 @@ execution time on CPUs was about 12ms, with a 2ms standard deviation, over
 1240 samples. It is a good idea to check this before doing actual performance
 1240 samples. It is a good idea to check this before doing actual performance
 measurements.
 measurements.
 
 
+A graph can be drawn by using the @code{starpu_perfmodel_plot}:
+
+@example
+$ starpu_perfmodel_display -s starpu_dlu_lu_model_22
+98304 393216 1572864 
+$ gnuplot starpu_starpu_dlu_lu_model_22.gp
+$ gv regression_starpu_dlu_lu_model_22.eps
+@end example
+
 If a kernel source code was modified (e.g. performance improvement), the
 If a kernel source code was modified (e.g. performance improvement), the
 calibration information is stale and should be dropped, to re-calibrate from
 calibration information is stale and should be dropped, to re-calibrate from
 start. This can be done by using @code{export STARPU_CALIBRATE=2}.
 start. This can be done by using @code{export STARPU_CALIBRATE=2}.

+ 4 - 12
tools/Makefile.am

@@ -29,28 +29,20 @@ CLEANFILES = *.gcno *.gcda *.linkinfo
 
 
 bin_PROGRAMS += starpu_calibrate_bus
 bin_PROGRAMS += starpu_calibrate_bus
 
 
-starpu_calibrate_bus_SOURCES = starpu_calibrate_bus.c
-
 if STARPU_USE_FXT
 if STARPU_USE_FXT
 bin_PROGRAMS += starpu_fxt_tool starpu_fxt_stats
 bin_PROGRAMS += starpu_fxt_tool starpu_fxt_stats
 
 
-starpu_fxt_tool_SOURCES = starpu_fxt_tool.c
 starpu_fxt_tool_CPPFLAGS = $(AM_CFLAGS) $(AM_CPPFLAGS) $(FXT_CFLAGS)
 starpu_fxt_tool_CPPFLAGS = $(AM_CFLAGS) $(AM_CPPFLAGS) $(FXT_CFLAGS)
 starpu_fxt_tool_LDADD = $(FXT_LIBS)
 starpu_fxt_tool_LDADD = $(FXT_LIBS)
 
 
-starpu_fxt_stats_SOURCES = starpu_fxt_stats.c
 starpu_fxt_stats_CPPFLAGS = $(AM_CFLAGS) $(AM_CPPFLAGS) $(FXT_CFLAGS)
 starpu_fxt_stats_CPPFLAGS = $(AM_CFLAGS) $(AM_CPPFLAGS) $(FXT_CFLAGS)
 starpu_fxt_stats_LDADD = $(FXT_LIBS)
 starpu_fxt_stats_LDADD = $(FXT_LIBS)
 endif
 endif
 
 
-bin_PROGRAMS +=	starpu_perfmodel_display
+bin_PROGRAMS += \
-starpu_perfmodel_display_SOURCES = starpu_perfmodel_display.c
+	starpu_perfmodel_display	\
-
+	starpu_perfmodel_plot 		\
-bin_PROGRAMS +=	starpu_regression_display
+	starpu_machine_display
-starpu_regression_display_SOURCES = starpu_regression_display.c
-
-bin_PROGRAMS += starpu_machine_display
-starpu_machine_display_SOURCES = starpu_machine_display.c
 
 
 noinst_PROGRAMS =	cbc2paje lp2paje
 noinst_PROGRAMS =	cbc2paje lp2paje
 
 

tools/starpu_regression_display.c → tools/starpu_perfmodel_plot.c