Install required software libraries

This chapter lists the required software libraries that you must have installed on your system in order to use HEMCO standalone.

  • If you are using a shared computer cluster, then many of these libraries have probably already been pre-installed by your IT staff. Consult with them for more information.

  • If you plan to run HEMCO standalone on the Amazon Web services cloud, then all of these libraries will be included with the Amazon Machine Image (AMI) that you will use to start your cloud instance. You may skip ahead to the Download the source code chapter.

  • If your computer cluster has none of these libraries installed, then you will have to install them yourself. See our supplemental guide Build required software with Spack for detailed installation instructions.

Supported compilers for HEMCO

HEMCO is written in the Fortran programming language. However, you will also need C and C++ compilers to install certain libraries (like netCDF) on your system.

The Intel Compiler Suite

The Intel Compiler Suite is our recommended proprietary compiler suite.

Intel compilers produce well-optimized code that runs extremely efficiency on machines with Intel CPUs. Many universities and institutions will have an Intel site license that allows you to use these compilers.

The GCST has tested HEMCO with these versions (but others may work as well):

  • 23.0.0

  • 19.0.5.281

  • 19.0.4

  • 18.0.5

  • 17.0.4

  • 15.0.0

  • 13.0.079

  • 11.1.069

Best way to install: With Spack (Intel 2021 and later); Directly from Intel (older versions).

The GNU Compiler Collection

The GNU Compiler Collection (or GCC for short) is our recommended open-source compiler suite.

Because the GNU Compiler Collection is free and open source, this is a good choice if your institution lacks an Intel site license, or if you are running HEMCO standalone on the Amazon EC2 cloud environment.

The GCST has tested HEMCO standalone with these versions (but others may work as well):

  • 12.2.0

  • 11.2.0

  • 11.1.0

  • 10.2.0

  • 9.3.0

  • 9.2.0

  • 8.2.0

  • 7.4.0

  • 7.3.0

  • 7.1.0

  • 6.2.0

Best way to install: With Spack.

Required software packages for HEMCO

Git

Git is the de-facto software industry standard package for source code management. A version of Git usually ships with most Linux OS builds.

The HEMCO source code can be downloaded using the Git source code management system from the https://github.com/HEMCO repository.

Best way to install: git-scm.com/downloads. But first check if you have a version of Git pre-installed.

CMake

CMake is software that creates Makefiles, or scripts that direct how the HEMCO source code will be compiled into an executable. You will need CMake version 3.13 or later to build HEMCO.

Best way to install: With Spack.

GNU Make

GNU Make (sometimes just known as make) is software that can build executables from source code. It executes the instructions in the Makefiles created by CMake.

Best way to install: With Spack.

The netCDF library (plus dependencies)

HEMCO input and output data files use the netCDF file format (cf. netCDF). NetCDF is a self-describing file format hat allows meadata (descriptive text) to be stored alongside data values.

Best way to install: With Spack.