1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
.. role:: ref(emphasis)
.. _futhark-autotune(1):
================
futhark-autotune
================
SYNOPSIS
========
futhark autotune [options...] <program.fut>
DESCRIPTION
===========
``futhark autotune`` attemps to find optimal values for threshold
parameters given representative datasets. This is done by repeatedly
running running the program through :ref:`futhark-bench(1)` with
different values for the threshold parameters. When ``futhark
autotune`` finishes tuning a program ``foo.fut``, the results are
written to ``foo.fut.tuning``, which will then automatically be picked
up by subsequent uses of :ref:`futhark-bench(1)` and
:ref:`futhark-test(1)`.
OPTIONS
=======
--backend=name
The backend used when compiling Futhark programs (without leading
``futhark``, e.g. just ``opencl``).
--futhark=program
The program used to perform operations (eg. compilation). Defaults
to the binary running ``futhark autotune`` itself.
--pass-option=opt
Pass an option to programs that are being run. For example, we
might want to run OpenCL programs on a specific device::
futhark autotune prog.fut --backend=opencl --pass-option=-dHawaii
--runs=count
The number of runs per data set.
-v, --verbose
Print verbose information about what the tuner is doing. Pass
multiple times to increase the amount of information printed.
--skip-compilation
Do not run the compiler, and instead assume that the program has
already been compiled. Use with caution.
--spec-file=FILE
Ignore the test specification in the program file(s), and instead
load them from this other file. These external test specifications
use the same syntax as normal, but *without* line comment prefixes A
``==`` is still expected.
--tuning=EXTENSION
Change the extension used for tuning files (``.tuning`` by default).
--timeout=seconds
Initial tuning timeout for each dataset in seconds. After running the intitial
tuning run on each dataset, the timeout is based on the run time of that
initial tuning. Defaults to 60.
A negative timeout means to wait indefinitely.
SEE ALSO
========
:ref:`futhark-bench(1)`
|
