FDS Compilation

Compiling FDS

Quick Start on Linux

• Install Intel Fortran compiler
• Define IFORT_COMPILER variable as /opt/intel/composerxe
• cd to FDS-SMV/FDS_Compilation/intel_linux_64
• Run ./make_fds.sh

Full Compilation Information

Preliminaries

This page describes how to build FDS using command line tools that come with the Intel Fortran compiler.

• Install the Intel Fortran compiler.
• Install (or update to the most recent revision) the FDS-Smokeview SVN repository ([Accessing_Subversion_Repository See this Wiki] for more details.)
• Define the IFORT_COMPILER environment variable to point to where your compiler resides. For example for the bash shell place the following line:

export IFORT_COMPILER=/opt/intel/composerxe

in your .bashrc (Linux) or .bash_profile (Mac OS X) start up file.

For the tcsh shell, place the following line:

setenv IFORT_COMPILER /opt/intel/composerxe

in your .tcsh start up file. (Of course put in your own compiler location)

• If you are working on a Windows PC, install the GNU make utility (http://gnuwin32.sourceforge.net/downlinks/make.php). Other download options may be found at http://gnuwin32.sourceforge.net/packages/make.htm. If the command doesn't work, add the location of the make application to your PATH.
• If you are working on a Windows PC, install MPICH2 (http://www.mcs.anl.gov/research/projects/mpich2/) if you wish to build a parallel/MPI version of FDS . Under Linux, OSX, or some other form of Unix, install OpenMPI.

Building FDS

There is a general purpose makefile for FDS compilation in the FDS/SVN repository directory called FDS_Compilation. To compile FDS for your particular OS, do the following:

• Open a command shell and cd to the FDS_Compilation\intel_win_32 directory within the FDS-Smokeview repository. If you are working under Linux or OS X, 32 or 64 bit, choose the appropriate folder, such as intel_linux_64 or intel_osx_64 for the Intel compilers, or gnu_linux_32 and gnu_osx_32 for the GNU compilers.
• Type make_fds.bat or make_fds.sh, depending on your OS.

Alternatively on a Windows PC you may

• Open the directory FDS_Compilation\intel_win_32 directory within the FDS-Smokeview repository using the Windows Explorer interface
• Double-click on the make_fds.bat batch file

If you get stuck, take a look at the make_fds script to better understand what is actually happening. Chances are that there a different path name or compiler version number installed on your machine.

Profiling FDS

Steps to determine where FDS spends its time executing.

Build FDS: cd into FDS_Compilation/intel_linux_32_profile and type:

./make_fds.sh

Run FDS:

 fds_intel_32_profile casename.fds

Generate profiling results:

 gprof fds_intel_32_profile > profile.out

Notes:

• The intel_linux_32_profile makefile entry was derived from intel_linux_32. The -O3 option was changed to -O2 and the -p profiling option was added.

The profiling results may now be viewed in the file profile.out