Installation requirements

In order to compile and install FALL3D you need:

  • Unix-like operating system (MacOS or Linux)
  • A modern Fortran compiler (e.g., gfortran, ifort, xlf90)
  • Git version management (optional)

The parallel version also requires:

  • An MPI library with Fortran support. For example: OpenMPI, Intel MPI or MVAPICH2

In addition, the following optional dependencies are recommended:

  • Doxygen, required to generate useful code documentation for developers
  • Python (>=3.8), required to run pre-processing and download tools

External libraries

FALL3D requires netCDF libraries. Specifically:

  • The netCDF-Fortran library with netCDF-4 support
  • For parallel I/O support on classic netCDF files, PnetCDF 1.6.0 or later is required

Getting pre-built netCDF libraries

The easiest way to get netCDF is through a package management program (e.g. apt, rpm, yum, homebrew). NetCDF is available from many different repositories, including the Ubuntu main repositories.

When getting netCDF from a software repository, you should get a development version. A development version will typically have a name such as "netcdf-devel" or "libnetcdf-dev". For example, you can install the netCDF Fortran library in Ubuntu with the command:

sudo apt install libnetcdff-dev

Building netCDF

The netCDF Fortran libraries depend on the netCDF C library which requires third-party libraries for full functionality, including:

  • HDF5 1.8.9 or later (for netCDF-4 support)
  • zlib 1.2.5 or later (for netCDF-4 compression)

And, optionally,

  • PnetCDF 1.6.0 or later (for parallel I/O support on classic netCDF files)

For information regarding the netCDF-C libraries, see Building netCDF-C and for netCDF-Fortran libraries, see Building the NetCDF-4.2 and later Fortran libraries.