Fortran Compilers

This section is relevant to users who want to compile the fortran code in the classic, amrclaw, or geoclaw branches.

FC environment variable

Users should set the environment variable FC to point to the correct compiler, e.g. in bash via:

$ export FC=gfortran

Note that some versions of make will set FC=f77 by default if no value is specified, and adding a line to the Makefile such as:

FC ?= gfortran

will not override this. The common Makefile in $CLAW/clawutil/src/Makefile.common now tests to see if FC is set to f77 and if so resets it to gfortran since much of Clawpack is not f77 compliant. However, it is best to set the FC environment variable yourself, e.g. in your .bashrc file.

FFLAGS environment variable

Compiler flags can be specified using the FFLAGS variable that can be set in an application Makefile. By default sample Makefiles now specify:

FFLAGS ?=

so that no flags are used unless the environment variable FFLAGS is set already. This line can be changed in the Makefile, but it is often easiest to set an environment variable for the flags you generally want to use.

Note: If you change the flags you generally have to recompile all the code, and this dependency is not handled automatically. So always do:

$ make new

before rerunning an example with make .output or make .plots.

LFLAGS environment variable

The LFLAGS environment variable is used to provide flags that are needed when linking the final binary. The most likely use for this flag would be to link a particular library with the binary (such as a NetCDF library) or provide a path to a compiled module. If this variable is not set in the environment then LFLAGS defaults to the relevant flags in FFLAGS.

Pre-Processor and the PPFLAGS environment variable

Compilers often provide a pre-processor that can scan source code before compilation providing some ability to define variables at compile time or transform the code. Currently the pre-processor is always called before Clawpack compilation to support optional dependencies, such as NetCDF support, and some testing abilities. The PPFLAGS environment variable is meant to provide further control of the pre-processor.

gfortran compiler

Some useful flags:

  • For debugging:

    FFLAGS = -g -Wall -pedantic -fbounds-check -ffpe-trap=invalid,overflow,zero
    
  • For optimizing:

    FFLAGS = -O2
    
  • For using OpenMP:

    FFLAGS = -O2 -fopenmp
    

    In this case you should also set some environment variables. See Using OpenMP for details.

    Note: Versions of gfortran before 4.6 are known to have OpenMP bugs.

  • For using NetCDF:

    FFLAGS = -DNETCDF -lnetcdf -I$(NETCDF4_DIR)/include
    LFLAGS = -lnetcdf
    

    The FFLAGS can also be put into PPFLAGS. Note that the variable NETCDF4_DIR should be defined in the environment.

Intel fortran compiler

Set the FC environment variable to ifort.

Some useful flags:

  • For debugging:

    FFLAGS = -g -C -CB -CU -fpe0 -ftrapuv -fp-model precise
    
  • For optimizing:

    FFLAGS = -O2
    
  • For using OpenMP:

    FFLAGS = -O2 -openmp
    

    In this case you should also set the environment variable OMP_NUM_THREADS to indicate how many threads to use.

  • For using NetCDF:

    FFLAGS = -DNETCDF -lnetcdf -I$(NETCDF4_DIR)/include
    LFLAGS = -lnetcdf
    

    Same as for gfortran above.