Compiling GEOS-Chem

From Geos-chem
Jump to: navigation, search

Previous | Next | Getting Started with GEOS-Chem

  1. Minimum system requirements (and software installation)
  2. Configuring your computational environment
  3. Downloading source code
  4. Downloading data directories
  5. Creating run directories
  6. Configuring runs
  7. Compiling
  8. Running
  9. Output files
  10. Python tools for use with GEOS-Chem
  11. Coding and debugging
  12. Further reading


Overview

GEOS-Chem and GCHP use two build systems to compile source code files into an executable file:

  1. GNU Make
  2. CMake

Starting in 13.0.0 both GEOS-Chem "Classic" and GCHP use CMake exclusively.

Which versions can use GNU Make and which can use CMake?

GEOS-Chem "Classic" compatibility matrix

Some GEOS-Chem "Classic" versions are compatible with both CMake and GNU Make, as shown below.

GEOS-Chem "Classic" version Uses GNU Make? Uses CMake?
12.5.0 and prior YES NO
12.6.* YES YES
12.7.* YES YES
12.8.* YES YES
12.9.* YES YES
13.0.0 and later NO YES

GCHP compatibility matrix

Unlike GEOS-Chem "Classic", GCHP had a "hard" transition from GNU Make to CMake in 13.0.0:

GCHP version Uses GNU Make? Uses CMake?
12.5.0 and prior YES NO
12.6.* YES NO
12.7.* YES NO
12.8.* YES NO
12.9.* YES NO
13.0.0 and later NO YES

References

  1. GNU Make Manual
  2. Mecklenburg, Robert, Managing Projects with GNU Make, Third Edition,, O'Reilly and Associates, 2004.
  3. CMake FAQ by Liam Bindle
  4. CMake tutorial (cmake.org)
  5. Learn X in Y minutes (where X is CMake)



Previous | Next | Getting Started with GEOS-Chem