Compiling GEOS-Chem

Previous | Next | Getting Started with GEOS-Chem

1. Minimum system requirements
2. Installing required software
3. Configuring your computational environment
4. Downloading source code
5. Downloading data directories
6. Creating run directories
7. Configuring runs
8. Compiling
   • ... with CMake
   • ... with GNU Make
9. Running
10. Output files
11. Python tools for use with GEOS-Chem
12. Coding and debugging
13. 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

At present, both GEOS-Chem "Classic" and GCHP use GNU Make. CMake will soon replace GNU Make in both GEOS-Chem "Classic" and GCHP.

--Bob Yantosca (talk) 22:11, 20 December 2019 (UTC)

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 (release TBD) and later	NO	YES

GCHP compatibility matrix

Unlike GEOS-Chem "Classic", GCHP will have 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 (release TBD) 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