BLTK_REPORT(1)						      General Commands Manual						    BLTK_REPORT(1)

NAME

       bltk_report - automated report creation bltk_report_table - summary table creation from several results folders bltk_plot - graph drawing

SYNOPSIS

       bltk_report [-hdofI013EiS] [-r ] [-s ] [-b ] [-c ] [-U ] [-B ] [-D ] [-C ] [-P ] [-K ] [-R ] [-2 ] [-4 ] directory...

       bltk_report_table [-hdstfuEe13SR] [-2 ] [-4 ] [-F ] directory ...

       bltk_plot [-hDswy1vnr] [-d ] [-f ] [-x ] [-X ] [-Y ] [-t ] [-o ] [-2 ] [-p ] results_dir ...

DESCRIPTION

       The following tools are implemented for results analysis:

       bltk_report
	      automated report creation

       bltk_report_table
	      summary table creation from several results folders

       bltk_plot
	      graph drawing

GENERAL OPTIONS

       -h     theis help

       -1     first statistic item of score file is ignored

       -2 item:num
	      statistic from item 'item', 'num' number of score file

       -f     statistics file name

SPECIFIC OPTIONS

       bltk_report

	      -o     print report to output

	      -K string
		     comment string

	      -R filename
		     argument will be used as report file name

	      -3     first statistic item of stat.log file is ignored

	      -4 item:num
		     statistic from item 'item', 'num' number of stat.log file

	      -E     errors being ignored (allows to create report file anyway)

	      -i     idle mode

       bltk_report_table

	      -d     debugging mode

	      -s     sort result lines

	      -t     Excel-compatible file format

	      -3     first statistic item of stat.log file is ignored

	      -4 item:num
		     statistic from item 'item', 'num' number of stat.log file

	      -u     only columns which contain different values will be included into table

	      -E     errors being ignored (allows to create result table anyway)

	      -e     skip error results

	      -F filter
		     only fields from filter file will be included into table (see doc/filter as an example)

	      -S     split mode - split multiple values to columns

	      -R     analyze all results dirs under passed directories

       bltk_plot

	      -D     debugging mode

	      -d results_dir
		     results directory name. This option could be passed several times default is current directory.

	      -s     use stat.log file

	      -w     use work.log file

	      -x name
		     argument is used to be an X parameter default is 'time' field

	      -y name...
		     argument is used to be an Y parameter this option could be passed several times default is 'cap' field

	      -X x1:x2
		     x range from x1 to x2

	      -Y y1:y2
		     y range from y1 to y2

	      -t title
		     graph title

	      -o options
		     options passed to 'plot' command

	      -v     print current variables

	      -p file
		     save graph to specified file

	      -n     print available field's names

	      -R     analyze all results dirs under passed directories

EXAMPLE

       bltk_report_table <results1> ... <resultsn> >sum
	      Common results table will be generated in 'sum' file for <results1> ... <resultsn> directories.

       bltk_report result
	      'Report' file will be generated in results directory

       bltk_plot -y bat -x N <results_dir1> ... <results_dir>
	      Common graph will be generated for <results_dir1> ... <results_dirn>

SEE ALSO

       bltk(1), bltk.conf(5)

AUTHOR

       Konstantin Karasyov   <konstantin.a.karasyov@intel.com>
       Vladimir Lebedev      <vladimir.p.lebedev@intel.com>

BLTK_REPORT							   15 July 2008 						    BLTK_REPORT(1)