Install FFTW3 - Revision history

Correaa: /* demo */

2010-04-06T14:51:34Z

demo

← Older revision		Revision as of 14:51, 6 April 2010
Line 86:		Line 86:

	The official tutorial for the MPI version of FFTW3 can be found [http://www.fftw.org/fftw3.3alpha_doc/Distributed_002dmemory-FFTW-with-MPI.html#Distributed_002dmemory-FFTW-with-MPI here].		The official tutorial for the MPI version of FFTW3 can be found [http://www.fftw.org/fftw3.3alpha_doc/Distributed_002dmemory-FFTW-with-MPI.html#Distributed_002dmemory-FFTW-with-MPI here].

	== demo ==

	ddd

	dd

	= Compilation with Shared Libraries =		= Compilation with Shared Libraries =

Correaa: /* MPI version */

2010-04-06T14:51:20Z

MPI version

← Older revision		Revision as of 14:51, 6 April 2010
Line 86:		Line 86:

	The official tutorial for the MPI version of FFTW3 can be found [http://www.fftw.org/fftw3.3alpha_doc/Distributed_002dmemory-FFTW-with-MPI.html#Distributed_002dmemory-FFTW-with-MPI here].		The official tutorial for the MPI version of FFTW3 can be found [http://www.fftw.org/fftw3.3alpha_doc/Distributed_002dmemory-FFTW-with-MPI.html#Distributed_002dmemory-FFTW-with-MPI here].

			== demo ==

			ddd

			dd

	= Compilation with Shared Libraries =		= Compilation with Shared Libraries =

Correaa: /* Serial version only */

2010-02-27T01:46:06Z

Serial version only

← Older revision		Revision as of 01:46, 27 February 2010
Line 30:		Line 30:

	./configure --prefix=$HOME/usr --enable-shared=yes		./configure --prefix=$HOME/usr --enable-shared=yes
	make		make --jobs=8
	make install		make install

	The following files will be installed in:		(1 minute). The following files will be installed in:

	~/usr/include/fftw3.h		~/usr/include/fftw3.h

Correaa: /* MPI version */

2009-09-17T21:44:28Z

MPI version

← Older revision		Revision as of 21:44, 17 September 2009
Line 60:		Line 60:
	Do the same procedure of downloading the file and decompressing it, but add the --enable-mpi flag:		Do the same procedure of downloading the file and decompressing it, but add the --enable-mpi flag:

	./configure --prefix=$HOME/usr --enable-mpi --enable-shared=yes		./configure --prefix=$HOME/usr --enable-mpi --enable-shared=yes
	make install		make install

	now the library will be installed in your home directory, besides the files mentioned above, you will find also:		now the library will be installed in your home directory, besides the files mentioned above, you will find also:

Correaa: /* MPI version */

2009-09-17T21:44:18Z

MPI version

← Older revision		Revision as of 21:44, 17 September 2009
Line 52:		Line 52:
	To install the experimental MPI version of FFTW3, make sure you downloaded fftw-3.3alpha1 (and not fftw-3.2 for example). Also make sure that there is an MPI compiler available:		To install the experimental MPI version of FFTW3, make sure you downloaded fftw-3.3alpha1 (and not fftw-3.2 for example). Also make sure that there is an MPI compiler available:

	$which mpicc		$which mpicc
	/usr/bin/mpicc		/usr/bin/mpicc

	If it is not available, you can choose one with the command 'mpi-selector-menu' in wcr. I tested this with the 'openmpi_gcc-1.2.2' compiler. If that is not possible then set the variable MPICC, for example:		If it is not available, you can choose one with the command 'mpi-selector-menu' in wcr. I tested this with the 'openmpi_gcc-1.2.2' compiler. If that is not possible then set the variable MPICC, for example:
Line 65:		Line 65:
	now the library will be installed in your home directory, besides the files mentioned above, you will find also:		now the library will be installed in your home directory, besides the files mentioned above, you will find also:

	~/usr/include/fftw3-mpi.h		~/usr/include/fftw3-mpi.h
	~/usr/lib/libfftw3_mpi.a		~/usr/lib/libfftw3_mpi.a
	~/usr/lib/libfftw3_mpi.la		~/usr/lib/libfftw3_mpi.la
	~/usr/lib/libfftw3_mpi.so		~/usr/lib/libfftw3_mpi.so

	The typical command line for compilation will be		The typical command line for compilation will be

	export LD_RUN_PATH=$HOME/usr/lib #do this before compiling		export LD_RUN_PATH=$HOME/usr/lib #do this before compiling
	mpicc -I$HOME/usr mpi_program.c -L$HOME/usr/lib -lfftw3_mpi -lfftw3 -o mpi_program		mpicc -I$HOME/usr mpi_program.c -L$HOME/usr/lib -lfftw3_mpi -lfftw3 -o mpi_program

	Make sure to link first to fftw3_mpi and later to fftw3. For some MPI platforms (notably openmpi-gcc) setting LD_RUN_PATH does not do the job of storing the library path inside the executables (see note in previous section), it may be necessary to use the following command:		Make sure to link first to fftw3_mpi and later to fftw3. For some MPI platforms (notably openmpi-gcc) setting LD_RUN_PATH does not do the job of storing the library path inside the executables (see note in previous section), it may be necessary to use the following command:

	mpicc -Wl,-rpath=$HOME/usr/lib -I$HOME/usr mpi_program.c -L$HOME/usr/lib -lfftw3_mpi -lfftw3 -o mpi_program		mpicc -Wl,-rpath=$HOME/usr/lib -I$HOME/usr mpi_program.c -L$HOME/usr/lib -lfftw3_mpi -lfftw3 -o mpi_program

	In any case we should always check that the executable is properly linked by doing		In any case we should always check that the executable is properly linked by doing

	ldd ./mpi_program		ldd ./mpi_program

	and checking that all shared libraries are "found".		and checking that all shared libraries are "found".

Correaa: /* General Remarks */

2009-09-17T21:43:10Z

General Remarks

← Older revision		Revision as of 21:43, 17 September 2009
Line 7:		Line 7:
	As usual we would like to install the libraries in the user space, so we will create a couple of directories for that purpose:		As usual we would like to install the libraries in the user space, so we will create a couple of directories for that purpose:

	mkdir $HOME/usr		mkdir $HOME/usr
	mkdir $HOME/soft		mkdir $HOME/soft

	To install FFTW3, download the package from the [http://www.fftw.org/download.html FFTW3 download page] and decompress it:		To install FFTW3, download the package from the [http://www.fftw.org/download.html FFTW3 download page] and decompress it:

	cd ~/soft		cd ~/soft
	wget http://www.fftw.org/fftw-3.3alpha1.tar.gz		wget http://www.fftw.org/fftw-3.3alpha1.tar.gz
	tar -zxvf fftw-3.3alpha1.tar.gz		tar -zxvf fftw-3.3alpha1.tar.gz
	cd fftw-3.3alpha1		cd fftw-3.3alpha1

	'''Ubuntu only:''' If you want to install FFTW3 (serial version) in your local Ubuntu you can skip this installation section altogether and just run:		'''Ubuntu only:''' If you want to install FFTW3 (serial version) in your local Ubuntu you can skip this installation section altogether and just run:

Correaa: /* MPI version */

2009-06-08T20:57:55Z

MPI version

← Older revision		Revision as of 20:57, 8 June 2009
Line 77:		Line 77:
	Make sure to link first to fftw3_mpi and later to fftw3. For some MPI platforms (notably openmpi-gcc) setting LD_RUN_PATH does not do the job of storing the library path inside the executables (see note in previous section), it may be necessary to use the following command:		Make sure to link first to fftw3_mpi and later to fftw3. For some MPI platforms (notably openmpi-gcc) setting LD_RUN_PATH does not do the job of storing the library path inside the executables (see note in previous section), it may be necessary to use the following command:

	mpicc -Wl,rpath=$HOME/usr/lib -I$HOME/usr mpi_program.c -L$HOME/usr/lib -lfftw3_mpi -lfftw3 -o mpi_program		mpicc -Wl,-rpath=$HOME/usr/lib -I$HOME/usr mpi_program.c -L$HOME/usr/lib -lfftw3_mpi -lfftw3 -o mpi_program

	In any case we should always check that the executable is properly linked by doing		In any case we should always check that the executable is properly linked by doing

Correaa at 19:55, 4 June 2009

2009-06-04T19:55:10Z

← Older revision		Revision as of 19:55, 4 June 2009
Line 1:		Line 1:
			(original version by Alfredo Correa)

	FFTW3 is a library designed to compute discrete Fourier transforms. As described in the [http://www.fftw.org/ the official FFTW site], there are various versions available, with different features and different levels of maturity. In this tutorial I deal with the installation of version 3, including the experimental MPI version. However the installation instructions seems to be valid (although not tested) also for the more popular version 2.		FFTW3 is a library designed to compute discrete Fourier transforms. As described in the [http://www.fftw.org/ the official FFTW site], there are various versions available, with different features and different levels of maturity. In this tutorial I deal with the installation of version 3, including the experimental MPI version. However the installation instructions seems to be valid (although not tested) also for the more popular version 2.

Correaa: /* MPI version */

2009-03-25T20:54:05Z

MPI version

← Older revision		Revision as of 20:54, 25 March 2009
Line 53:		Line 53:
	/usr/bin/mpicc		/usr/bin/mpicc

	If it is not available, you can choose one with the command 'mpi-selector-menu' in wcr. I tested this with the 'openmpi_gcc-1.2.2' compiler.		If it is not available, you can choose one with the command 'mpi-selector-menu' in wcr. I tested this with the 'openmpi_gcc-1.2.2' compiler. If that is not possible then set the variable MPICC, for example:
			<code>export MPICC=$HOME/usr/bin/mpicc</code>.

	Do the same procedure of downloading the file and decompressing it, but add the --enable-mpi flag:		Do the same procedure of downloading the file and decompressing it, but add the --enable-mpi flag:

Correaa: /* Compilation with Shared Libraries */

2009-03-03T09:27:13Z

Compilation with Shared Libraries

← Older revision		Revision as of 09:27, 3 March 2009
Line 88:		Line 88:
	In the command line compilation examples above I set the variables LD_RUN_PATH. Using LD_RUN_PATH saves us from having to set path variables before running the program, such as LD_LIBRARY_PATH (which is a [http://linuxmafia.com/faq/Admin/ld-lib-path.html bad practice]). When LD_RUN_PATH is set before compilation, the created executable will store the search path of the shared library internally (but will not enforce it). I learned this trick from http://gcc.gnu.org/faq.html#rpath and it works well with gcc at least. Setting this variable before compilation can be annoying, but is better than having to set variables each time we use the executable. This seems to be the only good option left when using libraries installed in the home directory (does anybody know a better alternative?).		In the command line compilation examples above I set the variables LD_RUN_PATH. Using LD_RUN_PATH saves us from having to set path variables before running the program, such as LD_LIBRARY_PATH (which is a [http://linuxmafia.com/faq/Admin/ld-lib-path.html bad practice]). When LD_RUN_PATH is set before compilation, the created executable will store the search path of the shared library internally (but will not enforce it). I learned this trick from http://gcc.gnu.org/faq.html#rpath and it works well with gcc at least. Setting this variable before compilation can be annoying, but is better than having to set variables each time we use the executable. This seems to be the only good option left when using libraries installed in the home directory (does anybody know a better alternative?).

	Update on LD_RUN_PATH: It seems that the trick of setting this variable does not work with mpicxx, at least with the openmpi implementation. A more general way to store the path of the libraries in the executable seems to be to use the option '-Wl,rpath=$HOME/usr/lib' (sic); as described [http://wiki.grid.org/UserGuide_How_to_Compile_and_Build_a_MPI_Application#OpenMPI here].		Update on LD_RUN_PATH: It seems that the trick of setting this variable does not work with mpicxx, at least with the openmpi implementation. A more general way to store the path of the libraries in the executable seems to be to use the option '-Wl,-rpath=$HOME/usr/lib' (sic); as described [http://wiki.grid.org/UserGuide_How_to_Compile_and_Build_a_MPI_Application#OpenMPI here].

	Another option to avoid this issues all together is to use the -static option when compiling to ensure that the static fftw3 library files are embedded in the executable.		Another option to avoid this issues all together is to use the -static option when compiling to ensure that the static fftw3 library files are embedded in the executable.