This file contains information about options in the 'makefile' included
with this distribution.

To compile SA_MESH, run 'make' with one of the following targets:
Serial (sa_mesh):
  $ make gfortran
  $ make ifort
  $ mingw32-make mingw_static
Parallel (mpi_sa_mesh; requires OpenMPI compiler):
  $ make mpi_gcc
  $ make mpi_intel

If no target is specified, 'gfortran' is assumed.
  $ make

The makefile will automatically remove *.o and *.mod files if the
compile process is successful.

Recommended for Cygwin, Ubuntu (without Intel license)
To create 'sa_mesh':
  $ make
To create 'mpi_sa_mesh':
  $ make mpi_gcc

Recommended for Linux where the Intel license is available:
To create 'sa_mesh':
  $ make ifort
To create 'mpi_sa_mesh':
  $ make mpi_intel

Description of target to compiler:
  - gfortran: GNU compiler (gcc and gfortran).
  - ifort: Intel compiler (ifort).
  - mingw_static: MinGW MS-Windows/MS-DOS GNU distribution.
  - mpi_gcc*: GNU version of OpenMPI compiler (mpifort).
  - mpi_intel*: Intel version of OpenMPI compiler (mpifort).
*'mpi_gcc' and 'mpi_intel' are not interchangeable, even though in both
cases the compiler is named 'mpifort'. The code will also check for the
compiler named 'mpif90'.

To remove remaining *.o and *.mod files:
  $ make clean
*For MinGW, DIST=mingw must also be provided.
Examples:
  - To remove *.o and *.mod files in Cygwin/Linux environment:
      $ make clean
  - To remove *.o and *.mod files in MS-Windows/MS-DOS environment:
      $ mingw32-make clean DIST=mingw

To remove remaining *.o and *.mod files, and the compiled program:
  $ make veryclean
*For MinGW, DIST=mingw must also be provided.
*For 'mpi_gcc' and 'mpi_intel', MPI=ompi must also be provided.
Examples:
  - To remove *.o and *.mod files, and 'sa_mesh' in Cygwin/Linux
    environment:
      $ make veryclean
  - To remove *.o and *.mod files, and 'mpi_sa_mesh' in Cygwin/Linux
    environment:
      $ make veryclean MPI=ompi
  - To remove *.o and *.mod files, and 'sa_mesh_static' in
    MS-Windows/MS-DOS environment:
      $ mingw32-make veryclean DIST=mingw

The following options can be added to the compiler targets to enable
or add features.
  - symbols: Disable code optimization and add debugging symbols.
  - debug: Same as 'symbols' but also enabled extra debugging options
        and traps.
  - double: Enable double precision (only impacts code where default
        precision on types is used).
  - netcdf: Enable NetCDF file support (requires the NetCDF Fortran
        library, not included with this code -- often available as a
        system package or module on managed systems).
Examples:
  - To compile 'sa_mesh' using GNU compilers with strict debug options:
      $ make debug
  - To compile 'sa_mesh' using ifort compiler with strict debug options:
      $ make ifort debug
  - To compile 'mpi_sa_mesh' using GNU compilers with NetCDF support
    (requires the NetCDF Fortran library):
      $ make mpi_gcc netcdf
  - To compile 'sa_mesh' using GNU compilers with double precision:
      $ make double
  - To compile 'mpi_sa_mesh' using the Intel compiler with NetCDF
    support (requires the NetCDF Fortran library) and double precision:
      $ make mpi_intel double

The above targets are wrappers to configure variables in the makefile.
However, these variables can also be set directly without using any
target. The direct variables can be set as follows:
    DIST: Compiler family/distribution.
      - Blank/undefined to use GNU compilers (default).
      - 'intel' to use the Intel compiler.
      - 'mingw' to use MinGW GNU-based compiler; overrides 'rm' with
        'del' for MS-Windows/MS-DOS environment when cleaning up files.
    MPI: Parallel/serial compilation.
      - Blank/undefined to compile in serial (default).
      - 'ompi' to compile using OMPI compiler.
    LSS: Land surface scheme (LSS).
      - Blank/undefined to include default versions of CLASS+SVS
        (default).
    ROUTE: Routing scheme.
      - Blank/undefined to include default versions of
        WF_ROUTE+SA_RTE+RTE (default).
    SYMBOLS: Symbols.
      - Blank/undefined to compile with 'O2' optimization (default).
      - 'yes' to add debugging symbols.
    DEBUG: Debugging flags and options.
      - Blank/undefined to compile with options determined by 'SYMBOLS'
        (default).
      - 'yes' to include debugging symbols and extra debugging traps and
        options.
    DOUBLE: Single/double precision.
      - Blank/undefined to use single precision.
      - 'yes' to use double precision (only impacts code where default
        precision on types is used).
Examples:
  - To compile 'mpi_sa_mesh' using the Intel compiler (equivalent to
    'make mpi_intel'):
      $ make DIST=intel MPI=ompi
  - To compile 'sa_mesh' using GNU compilers with debug flags/options
    (equivalent to 'make debug'):
      $ make DEBUG=yes