|
cannam@167
|
1 This directory contains a benchmarking and testing program
|
|
cannam@167
|
2 for fftw3.
|
|
cannam@167
|
3
|
|
cannam@167
|
4 The `bench' program has a zillion options, because we use it for
|
|
cannam@167
|
5 benchmarking other FFT libraries as well. This file only documents
|
|
cannam@167
|
6 the basic usage of bench.
|
|
cannam@167
|
7
|
|
cannam@167
|
8 Usage: bench <commands>
|
|
cannam@167
|
9
|
|
cannam@167
|
10 where each command is as follows:
|
|
cannam@167
|
11
|
|
cannam@167
|
12 -s <problem>
|
|
cannam@167
|
13 --speed <problem>
|
|
cannam@167
|
14
|
|
cannam@167
|
15 Benchmarks the speed of <problem>.
|
|
cannam@167
|
16
|
|
cannam@167
|
17 The syntax for problems is [i|o][r|c][f|b]<size>, where
|
|
cannam@167
|
18
|
|
cannam@167
|
19 i/o means in-place or out-of-place. Out of place is the default.
|
|
cannam@167
|
20 r/c means real or complex transform. Complex is the default.
|
|
cannam@167
|
21 f/b means forward or backward transform. Forward is the default.
|
|
cannam@167
|
22 <size> is an arbitrary multidimensional sequence of integers
|
|
cannam@167
|
23 separated by the character 'x'.
|
|
cannam@167
|
24
|
|
cannam@167
|
25 (The syntax for problems is actually richer, but we do not document
|
|
cannam@167
|
26 it here. See the man page for fftw-wisdom for more information.)
|
|
cannam@167
|
27
|
|
cannam@167
|
28 Example:
|
|
cannam@167
|
29
|
|
cannam@167
|
30 ib256 : in-place backward complex transform of size 256
|
|
cannam@167
|
31 32x64 : out-of-place forward complex 2D transform of 32 rows
|
|
cannam@167
|
32 and 64 columns.
|
|
cannam@167
|
33
|
|
cannam@167
|
34 -y <problem>
|
|
cannam@167
|
35 --verify <problem>
|
|
cannam@167
|
36
|
|
cannam@167
|
37 Verify that FFTW is computing the correct answer.
|
|
cannam@167
|
38
|
|
cannam@167
|
39 The program does not output anything unless an error occurs or
|
|
cannam@167
|
40 verbosity is at least one.
|
|
cannam@167
|
41
|
|
cannam@167
|
42 -v<n>
|
|
cannam@167
|
43
|
|
cannam@167
|
44 Set verbosity to <n>, or 1 if <n> is omitted. -v2 will output
|
|
cannam@167
|
45 the created plans with fftw_print_plan.
|
|
cannam@167
|
46
|
|
cannam@167
|
47 -oestimate
|
|
cannam@167
|
48 -opatient
|
|
cannam@167
|
49 -oexhaustive
|
|
cannam@167
|
50
|
|
cannam@167
|
51 Plan with FFTW_ESTIMATE, FFTW_PATIENT, or FFTW_EXHAUSTIVE, respectively.
|
|
cannam@167
|
52 The default is FFTW_MEASURE.
|
|
cannam@167
|
53
|
|
cannam@167
|
54 If you benchmark FFTW, please use -opatient.
|
|
cannam@167
|
55
|
|
cannam@167
|
56 -onthreads=N
|
|
cannam@167
|
57
|
|
cannam@167
|
58 Use N threads, if FFTW was compiled with --enable-threads. N
|
|
cannam@167
|
59 must be a positive integer; the default is N=1.
|
|
cannam@167
|
60
|
|
cannam@167
|
61 -onosimd
|
|
cannam@167
|
62
|
|
cannam@167
|
63 Disable SIMD instructions (e.g. SSE or SSE2).
|
|
cannam@167
|
64
|
|
cannam@167
|
65 -ounaligned
|
|
cannam@167
|
66
|
|
cannam@167
|
67 Plan with the FFTW_UNALIGNED flag.
|
|
cannam@167
|
68
|
|
cannam@167
|
69 -owisdom
|
|
cannam@167
|
70
|
|
cannam@167
|
71 On startup, read wisdom from a file wis.dat in the current directory
|
|
cannam@167
|
72 (if it exists). On completion, write accumulated wisdom to wis.dat
|
|
cannam@167
|
73 (overwriting any existing file of that name).
|
