8 August 2011 2 Comments
This article explains how to install the numbench script and to run the benchmarks.
First of all, the science overlay has to be added through layman; therefore, install layman on your Gentoo system if you don’t have it already, and do:
layman -L layman -a science
After that you will be able to install the package app-benchmarks/numbench. Remember that numbench is still unstable and therefore I will need to install the ~x86/~amd64 version.
The package installs the executable “numbench”, some Python data and a man page numbench(1).
I recommend to add the bicatali overlay through layman too, because it contains many numerical libraries that can be benchmarked, even if we are migrating them into the science overlay.
Run the benchmarks
In order to run the benchmarks you have to provide a configuration file. The man page explains how to write one, and you will find some examples under /usr/share/numbench/samples. Once you have your configuration file (say conf.in), and you have chosen the module to test (e.g. blas, lapack or lapack_accuracy; see man numbench or numbench -h), just run the command
numench module conf.in -s
The documentation explains how to run the test with more parameters in order to choose the tests that have to be performed.
After the execution you will find interesting directories under ~/.benchmarks:
- log contains the log, obviously; they are divided in subfolders in case of multiple runs
- packages contains the packages that are useful if you decide to install some tested one (the documentation here lacks)
- reports contains for each run a set of images, an HTML page and a copy of the logs; they are ready to be published somewhere, just copy the whole folder in your www directory
- roots and tests are two directories which are used by the script for storing data; they are keeped in order not tu run the tests again if the results already exist