Compiling GEOS-Chem

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
   • ... with CMake
   • ... with GNU Make
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