annotate src/fftw-3.3.3/doc/html/Installation-and-Supported-Hardware_002fSoftware.html @ 83:ae30d91d2ffe

Replace these with versions built using an older toolset (so as to avoid ABI compatibilities when linking on Ubuntu 14.04 for packaging purposes)
author Chris Cannam
date Fri, 07 Feb 2020 11:51:13 +0000
parents 37bf6b4a2645
children
rev   line source
Chris@10 1 <html lang="en">
Chris@10 2 <head>
Chris@10 3 <title>Installation and Supported Hardware/Software - FFTW 3.3.3</title>
Chris@10 4 <meta http-equiv="Content-Type" content="text/html">
Chris@10 5 <meta name="description" content="FFTW 3.3.3">
Chris@10 6 <meta name="generator" content="makeinfo 4.13">
Chris@10 7 <link title="Top" rel="start" href="index.html#Top">
Chris@10 8 <link rel="up" href="Multi_002dthreaded-FFTW.html#Multi_002dthreaded-FFTW" title="Multi-threaded FFTW">
Chris@10 9 <link rel="prev" href="Multi_002dthreaded-FFTW.html#Multi_002dthreaded-FFTW" title="Multi-threaded FFTW">
Chris@10 10 <link rel="next" href="Usage-of-Multi_002dthreaded-FFTW.html#Usage-of-Multi_002dthreaded-FFTW" title="Usage of Multi-threaded FFTW">
Chris@10 11 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
Chris@10 12 <!--
Chris@10 13 This manual is for FFTW
Chris@10 14 (version 3.3.3, 25 November 2012).
Chris@10 15
Chris@10 16 Copyright (C) 2003 Matteo Frigo.
Chris@10 17
Chris@10 18 Copyright (C) 2003 Massachusetts Institute of Technology.
Chris@10 19
Chris@10 20 Permission is granted to make and distribute verbatim copies of
Chris@10 21 this manual provided the copyright notice and this permission
Chris@10 22 notice are preserved on all copies.
Chris@10 23
Chris@10 24 Permission is granted to copy and distribute modified versions of
Chris@10 25 this manual under the conditions for verbatim copying, provided
Chris@10 26 that the entire resulting derived work is distributed under the
Chris@10 27 terms of a permission notice identical to this one.
Chris@10 28
Chris@10 29 Permission is granted to copy and distribute translations of this
Chris@10 30 manual into another language, under the above conditions for
Chris@10 31 modified versions, except that this permission notice may be
Chris@10 32 stated in a translation approved by the Free Software Foundation.
Chris@10 33 -->
Chris@10 34 <meta http-equiv="Content-Style-Type" content="text/css">
Chris@10 35 <style type="text/css"><!--
Chris@10 36 pre.display { font-family:inherit }
Chris@10 37 pre.format { font-family:inherit }
Chris@10 38 pre.smalldisplay { font-family:inherit; font-size:smaller }
Chris@10 39 pre.smallformat { font-family:inherit; font-size:smaller }
Chris@10 40 pre.smallexample { font-size:smaller }
Chris@10 41 pre.smalllisp { font-size:smaller }
Chris@10 42 span.sc { font-variant:small-caps }
Chris@10 43 span.roman { font-family:serif; font-weight:normal; }
Chris@10 44 span.sansserif { font-family:sans-serif; font-weight:normal; }
Chris@10 45 --></style>
Chris@10 46 </head>
Chris@10 47 <body>
Chris@10 48 <div class="node">
Chris@10 49 <a name="Installation-and-Supported-Hardware%2fSoftware"></a>
Chris@10 50 <a name="Installation-and-Supported-Hardware_002fSoftware"></a>
Chris@10 51 <p>
Chris@10 52 Next:&nbsp;<a rel="next" accesskey="n" href="Usage-of-Multi_002dthreaded-FFTW.html#Usage-of-Multi_002dthreaded-FFTW">Usage of Multi-threaded FFTW</a>,
Chris@10 53 Previous:&nbsp;<a rel="previous" accesskey="p" href="Multi_002dthreaded-FFTW.html#Multi_002dthreaded-FFTW">Multi-threaded FFTW</a>,
Chris@10 54 Up:&nbsp;<a rel="up" accesskey="u" href="Multi_002dthreaded-FFTW.html#Multi_002dthreaded-FFTW">Multi-threaded FFTW</a>
Chris@10 55 <hr>
Chris@10 56 </div>
Chris@10 57
Chris@10 58 <h3 class="section">5.1 Installation and Supported Hardware/Software</h3>
Chris@10 59
Chris@10 60 <p>All of the FFTW threads code is located in the <code>threads</code>
Chris@10 61 subdirectory of the FFTW package. On Unix systems, the FFTW threads
Chris@10 62 libraries and header files can be automatically configured, compiled,
Chris@10 63 and installed along with the uniprocessor FFTW libraries simply by
Chris@10 64 including <code>--enable-threads</code> in the flags to the <code>configure</code>
Chris@10 65 script (see <a href="Installation-on-Unix.html#Installation-on-Unix">Installation on Unix</a>), or <code>--enable-openmp</code> to use
Chris@10 66 <a href="http://www.openmp.org">OpenMP</a> threads.
Chris@10 67 <a name="index-configure-329"></a>
Chris@10 68
Chris@10 69 <p><a name="index-portability-330"></a><a name="index-OpenMP-331"></a>The threads routines require your operating system to have some sort
Chris@10 70 of shared-memory threads support. Specifically, the FFTW threads
Chris@10 71 package works with POSIX threads (available on most Unix variants,
Chris@10 72 from GNU/Linux to MacOS X) and Win32 threads. OpenMP threads, which
Chris@10 73 are supported in many common compilers (e.g. gcc) are also supported,
Chris@10 74 and may give better performance on some systems. (OpenMP threads are
Chris@10 75 also useful if you are employing OpenMP in your own code, in order to
Chris@10 76 minimize conflicts between threading models.) If you have a
Chris@10 77 shared-memory machine that uses a different threads API, it should be
Chris@10 78 a simple matter of programming to include support for it; see the file
Chris@10 79 <code>threads/threads.c</code> for more detail.
Chris@10 80
Chris@10 81 <p>You can compile FFTW with <em>both</em> <code>--enable-threads</code> and
Chris@10 82 <code>--enable-openmp</code> at the same time, since they install libraries
Chris@10 83 with different names (&lsquo;<samp><span class="samp">fftw3_threads</span></samp>&rsquo; and &lsquo;<samp><span class="samp">fftw3_omp</span></samp>&rsquo;, as
Chris@10 84 described below). However, your programs may only link to <em>one</em>
Chris@10 85 of these two libraries at a time.
Chris@10 86
Chris@10 87 <p>Ideally, of course, you should also have multiple processors in order to
Chris@10 88 get any benefit from the threaded transforms.
Chris@10 89
Chris@10 90 <!-- -->
Chris@10 91 </body></html>
Chris@10 92