To make building your own tools easy, examine
`SRCdir/include/atlas_tvec.h`
which contains a host of prewritten routines and data structures to
make tool building easy.

All the tools I have written allow you to choose to keep only certain vectors of data (corresponding to columns of output in the timer output). To give an example, say we ran the following line:

c2d>./xdmmtst_atl -F 120 -N 10 100 10 -T 0 -# 3 > timer.out

This will use `gemmtst.c` to time all square problems between 10 and
100 in steps of 10, without doing any testing, forcing at least 120MFLOPS
of computation for timing accuracy, with three repetitions.

Here's the tools I have written so far:

`xatl2tvec`- : Reads in the output of a timer file, and produces
a standard timing vectors file that can be read by routines provided
in
`atlas_tvec.h`and all downstream tools. Example usage:c2d>./xatl2tvec -# 3

`xreducetvec`- : take tvec file with repetition timings and reduce them to single timings while adding simple statistics like min, max, and average.
`xcattvecs`- : take multiple vector files and combine them into
one file for later comparison. Renames vectors as necessary by
adding
`_#`

to repeated names coming from later files. Can specify for some vectors to get this statistical treatment, and other vectors to just use the first one found. `xtvec2plp`- : Take a standard tvec file and produce a standard
`ploticus`data file from it. `xmergetvecs`- : Take two standard tvecs that contain separate runs of the same data with non-overlapping data, and combine them into one vector. Eg., you do one run with and a second with . This routine will allow you to combine these ranges into one for charting all results in one graph. This can be done repeatedly to merge any number of runs together.
`xperctvecs`- : recast named tvecs as a percentage of a baseline.
Can also be used to compute speedup rather than percentage by adding
`-m 1.0`flag.

To see how these tools can be used together, you can trace the dependence chain of any of the charts that are autobuilt, as explained in §.

R. Clint Whaley 2016-07-28