Code Compilation on Sapelo2

Where should I compile my code?

IMPORTANT NOTE: Please do not compile code on the login node. Instead, please first start an interactive session with qlogin and compile the code on the interactive node.

Code compilation can be done on an interactive session that you can be started with the command

qlogin

For information on how to access the compute node interactively for code compilation, please see Running Jobs on Sapelo2 using Slurm.

---

Compilers

A number of Fortran and C/C++ compilers, as well as Java and scripting languages such as Perl and Python, are available on the Slurm test cluster.

Summary of main Fortran and C/C++ compilers installed:

	Portland Group (PGI)	Intel	GNU	OpenMPI	File extension
Fortran77	pgf77	ifort		mpif77	.f
Fortran90	pgf90	ifort	gfortran	mpif90	.f90
Fortran95	pgf95	ifort	gfortran	mpifort	.f95
C	pgcc	icc	gcc	mpicc	.c
C++	pgCC	icpc	g++	mpicxx	.C, .cpp, .cc

The various compiler suites are provided by their environment modules.

GNU compiler suites:

The following command will show all the modules that provide GCC compiler suites:

module spider GCC

Sample partial output of this command:

[shtsai@b1-1 ~]$ module spider GCC

-----------------------------------------------------------------------------------------------------------------
  GCC:
-----------------------------------------------------------------------------------------------------------------
    Description:
      The GNU Compiler Collection includes front ends for C, C++, Objective-C, Fortran, Java, and Ada, as well as
      libraries for these languages (libstdc++, libgcj,...).

     Versions:
        GCC/6.4.0-2.28
        GCC/7.3.0-2.30
        GCC/8.3.0
        GCC/9.2.0
     Other possible modules matches:
        GCCcore  gcccuda

-----------------------------------------------------------------------------------------------------------------
 

This output indicates that the following versions of GCC compilers are available:

• Version 6.4.0, with binutils 2.28, provided by the GCC/6.4.0-2.28 module, includes C, C++, and Fortran compilers.
• Version 7.3.0, with binutils 2.30, provided by the GCC/7.2.0-2.30 module, includes C, C++, and Fortran compilers.
• Version 8.3.0, with binutils 2.32, provided by the GCC/8.3.0 module, includes C, C++, and Fortran compilers.
• Version 9.2.0, with binutils 2.32, provided by the GCC/9.2.0 module, includes C, C++, and Fortran compilers.

We suggest that you run the module spider GCC command to check an updated list of GCC compilers available on the cluster.

PGI compiler suites:

The following command will show all the modules that provide PGI compiler suites:

module spider PGI

Sample output of this command

[shtsai@b1-1 ~]$  module spider PGI

------------------------------------------------------------------------------------------------------------------
  PGI: PGI/19.10-GCC-8.3.0-2.32
------------------------------------------------------------------------------------------------------------------
    Description:
      C, C++ and Fortran compilers from The Portland Group - PGI


    This module can be loaded directly: module load PGI/19.10-GCC-8.3.0-2.32

    Help:
      Description
      ===========
      C, C++ and Fortran compilers from The Portland Group - PGI
      
      
      More information
      ================
       - Homepage: https://www.pgroup.com/

This output indicates that the PGI v. 19.10 compiler suite is available currently.

Intel compiler suites:

The following command will show all the modules that provide Intel compiler suites:

module spider iccifort

Sample output of this command

[shtsai@b1-1 ~]$ module spider iccifort

-------------------------------------------------------------------------------------------------------------------------
  iccifort:
-------------------------------------------------------------------------------------------------------------------------
    Description:
      Intel C, C++ & Fortran compilers

     Versions:
        iccifort/2013_sp1.0.080
        iccifort/2015.2.164-GCC-4.8.5
        iccifort/2018.1.163-GCC-6.4.0-2.28
        iccifort/2019.5.281

-------------------------------------------------------------------------------------------------------------------------
  For detailed information about a specific "iccifort" package (including how to load the modules) use the module's full name.
  Note that names that have a trailing (E) are extensions provided by other modules.
  For example:

     $ module spider iccifort/2019.5.281
-------------------------------------------------------------------------------------------------------------------------

This output indicates that the following versions of the Intel compiler suites are available:

• Version 13 SP1, provided by the iccifort/2013_sp1.0.080 module.
• Version 15.2, provided by the iccifort/2015.2.164-GCC-4.8.5 module.
• Version 2018.0.1.163, provided by the iccifort/2018.1.163-GCC-6.4.0-2.28 module.
• Version 2019.5.281, provided by the iccifort/2019.5.281

LLVM compiler suites':

The following command will show all the modules that provide LLVM compilers:

module spider LLVM

How to load a compiler module

To use any of the compiler suite, please first load the corresponding module. For example, to use the GNU 8.3.0 compiler suite, load the module with

module load GCC/8.3.0

Once this module is loaded the gcc, g++, and gfortran for GCC v. 8.3.0 will be available in your path.

Please note that you can only have one compiler module loaded at a time. For more information about Environment Modules, please see lmod.

Some commonly used compiler options

PGI compiler suite:

Option	Description
-O0	Specifies no optimization, recommended for code debugging
-O1	Specifies local optimization
-O2	Specifies global optimization (this is the default, same as using -O)
-O3	Includes -O1, -O2 and more aggressive optimization. Use with care.
-fast	Chooses generally good optimization options for the platform. Type pgcc -fast -help to see the equivalent options.
-Mbounds	Performs runtime array bound check, recommended for code debugging
-g	Produces symbolic debug information in the object files.
-r8	Interpret REAL variables as DOUBLE PRECISION.
-B	Allow C++ style comments in C source code; these begin with ‘//’ and continue until the end of the current line. pgcc only.
-Kieee	Perform floating-point operations in strict conformance with the IEEE 754 standard. The default compilation is -Knoieee, which uses faster but very slightly less accurate methods.
-mp	Interpret OpenMP directives to explicitly parallelize regions of code for execution by multiple threads
-acc	Enable OpenACC pragmas and directives to explicitly parallelize regions of code for execution by accelerator devices. Use with the -ta option

NOTE When using optimization options, please check if your code becomes more efficient (in some cases optimization options will slow the code down) and if it still generates correct results. Many other compiler options are available. For more information on the PGI compilers, you can view the manual pages with the commands man pgf90, man pgcc, etc, after loading the pgi module.

Intel compiler suite:

Option	Description
-O0	Specifies no optimization, recommended for code debugging
-O2	Enables optimizations for speed. This is the generally recommended optimization level.
-O3	Performs -O2 optimizations and more aggressive loop transformations. Use with care.
-fast	Chooses generally good optimization options for the platform. Type pgcc -fast -help to see the equivalent options.
-Mbounds	Performs runtime array bound check, recommended for code debugging

---

Back to Top

Compiler Toolchains

On Sapelo2 we use the EasyBuild framework to install software applications. The EasyBuild toolchains are also available for users to compile their own code. Each toolchain provides a compiler suite and some basic libraries, such as MPI, BLAS, LAPACK, FFTW, etc.

foss toolchains:

Most software applications are installed with the foss toolchain, where foss is short for “Free and Open Source Software”.

The foss toolchain consists of:

• binutils (https://www.gnu.org/software/binutils/)
• the GNU Compiler Collection (GCC, https://gcc.gnu.org/), i.e. gcc (C), g++ (C++) and gfortran (Fortran)
• the Open MPI library (https://www.open-mpi.org/)
• the OpenBLAS (http://www.openblas.net/) + LAPACK (http://netlib.org/lapack) libraries
• the ScaLAPACK (http://netlib.org/scalapack) library is also included
• the FFTW library (http://fftw.org/)

The following foss toolchains are available:

• foss/2016b, includes GCC 5.4.0, OpenMPI 1.10.3, OpenBLAS 0.2.18, FFTW 3.3.4, ScaLAPACK 2.0.2
• foss/2018a, includes GCC 6.4.0, OpenMPI 2.1.2, OpenBLAS 0.2.20, FFTW 3.3.7, ScaLAPACK 2.0.2

When you load a toolchain, all it components will be loaded. For example:

ml foss/2016b

will load these modules:

• GCCcore/5.4.0
• binutils/2.26-GCCcore-5.4.0
• GCC/5.4.0-2.26
• numactl/2.0.11-GCC-5.4.0-2.26
• hwloc/1.11.3-GCC-5.4.0-2.26
• OpenMPI/1.10.3-GCC-5.4.0-2.26
• OpenBLAS/0.2.18-GCC-5.4.0-2.26-LAPACK-3.6.1
• gompi/2016b
• FFTW/3.3.4-gompi-2016b
• ScaLAPACK/2.0.2-gompi-2016b-OpenBLAS-0.2.18-LAPACK-3.6.1
• foss/2016b

iomkl toolchains:

The iomkl toolchain consists of

• the Intel compiler suite
• the OpenMPI libraries
• the Intel Math Kernel Libraries (MKL)

The following iomkl toolchains are available:

• iomkl/2013_sp1.0.080, includes the Intel 2013.SP1 compiler suite, OpenMPI 1.8.4, MKL 11.1.1.106
• iomkl/2015.02, includes the Intel 2015.2.164 compiler suite, OpenMPI 1.8.4, MKL 11.2.2.164
• iomkl/2018a, includes the Intel 2018.1.163 compiler suite, OpenMPI 2.1.2, MKL 2018.1.163

imvmkl toolchains:

The imvmkl toolchain consists of

• the Intel compiler suite
• the MVAPICH2 libraries
• the Intel Math Kernel Libraries (MKL)

The following imvmkl toolchains are available:

• imvmkl/2013_sp1.0.080, includes the Intel 2013_sp1.0.080 compiler suite, MVAPICH2 2.2, MKL 11.1.1.106
• imvmkl/2015.02, includes the Intel 2015.2.164 compiler suite, MVAPICH2 2.2, MKL 11.2.2.164
• imvmkl/2018a, includes the Intel 2018.1.163 compiler suite, MVAPICH2 2.2, MKL 2018.1.163

gmvolf toolchains:

The gmvolf toolchain consists of:

• binutils (https://www.gnu.org/software/binutils/)
• the GNU Compiler Collection (GCC, https://gcc.gnu.org/), i.e. gcc (C), g++ (C++) and gfortran (Fortran)
• the MVAPICH2 library (http://mvapich.cse.ohio-state.edu/)
• the OpenBLAS (http://www.openblas.net/) + LAPACK (http://netlib.org/lapack) libraries
• the ScaLAPACK (http://netlib.org/scalapack) library is also included
• the FFTW library (http://fftw.org/)

The following foss toolchains are available:

• gmvolf/2016b, includes GCC 5.4.0, MVAPICH2 2.2, OpenBLAS 0.2.18, FFTW 3.3.4, ScaLAPACK 2.0.2

---

Back to Top