Welcome to CPHSTL's benchmark form generator.
By filling out the appropriate fields you can generate a benchmark form for use with the CPHSTL benchmarking tool.
1. General input.
This section contains fields that must be filled in every time a form is generated.
Benchmark title:
The title is only used to name classes and functions in the form.
Constructor name:
Enter the name of the constructor here, only the name no paranthesis.
Driver:
Select
time
if you want to measure the execution time of your program.
Select
memory
if you want a memory measurement.
Select
branch
if you want to obtain the branch misprediction ratio.
Select
function
if you want to obtain statistics about a certain function.
If you choose
memory
you must fill in the fields in section 7 below.
If you choose
branch
you must fill in the field in section 7 marked
PAPI path
If you choose
function
you must fill in the fields in section 8 below.
time
memory
branch
function
Measurement interval:
Please choose an interval in which to measure your program.
[
-
] in steps of:
Runner:
Select
gnuplot
to get the result of the benchmark in a gnuplot. Select
text
to get the result printed on the screen. If you select
gnuplot
please fill in the fields in section 4 below.
gnuplot
text
2. Remote execution.
This section contains fields that must be filled in if the benchmark is to be run remotely.
Computer:
Enter the hostname of the remote computer here.
Gateway:
If you need to use a gateway to get to the benchmark host enter the name of the gateway here.
Connection protocol:
Select which protocol to use when connecting to the remote host.
rsh
ssh
Transfer protocol:
Select which protocol to use for copying files to the remote host.
rcp
scp
3. Compiler settings.
This section contains fields that allow you to adjust compiler settings.
Compiler:
The default compiler is
g++
. If you want to use another enter it here.
Compiler options:
The defaults compiler options are:
-Wall -W -pedantic -ansi
.
If you want to extend these compiler options enter the individual options separated by semicolons here. Beware that certain optimizations such as
-O3
can cause problems when
function
has been selected as driver.
Include files:
If you need to include any files in the benchmark drivers enter them separated by semicolons here.
4. Gnuplot settings.
This section contains fields that allow you to adjust the settings for gnuplot.
This section is only relevant if you have chosen
gnuplot
as the runner in section 1.
Gnuplot title:
Please enter a title for the gnuplot.
Curve title:
Please enter a title for the curve drawn by gnuplot.
5. Time settings.
This section is only relevant if you have chosen
time
as the driver in section 1.
Time unit:
Please choose which unit to measure the execution time in.
ns
micros
ms
s
min
hour
day
Dual exists:
Check this box if your functor has a member function called dual.
6. Memory measurement.
This section is only relevant if you have chosen
memory
or
branch
as the driver in section 1.
Memory measurement:
Please choose which measurement to report.
minor page faults
major page faults
cache miss
cache miss ratio
cache access
Memory measurement type:
Please choose which strategi to use to obtain the measurement.
single run
quad run
warmed up
PAPI path:
Enter the path where PAPI is installed on the benchmark host in this field.
7. Function settings.
This section is only relevant if you have chosen
function
as the driver in section 1.
Function name:
Enter the name of the function to profile in this field.
Function statistic:
Please choose which statistic to report.
no. of calls
relative cputime
8. Generate form.