GEOS-Chem v11-01 Online User's Guide

Previous | Next | Printable View (no frames)

5. GEOS-Chem Source Code Directory

The GEOS-Chem source code directory contains the Makefile and Fortran-90 source code files (i.e. *.F, *.F90 files). Compiling the source code with a Fortran compiler creates the GEOS-Chem executable geos.

The GEOS-Chem source code directory is kept in the following Git repository on

All official releases of the GEOS-Chem code shall originate from this repository. You can download the latest official GEOS-Chem release by means of the git clone command by typing the following at the command line:

git clone Code.v11-01

cd Code.v11-01

git checkout v11-01-Patches

This will create an exact copy (or clone) of the official GEOS-Chem repository to your local disk space in a directory named Code.v11-01. Using Code.v11-01 as your local repository name is optional and you may specify a different directory name if you wish. When you clone the source code you will always get the most recent state of the repository, meaning the latest GEOS-Chem version or bug fix patch.

NOTE: After the v11-01 public release date (01 Feb 2017), we discovered a computational bottleneck in the v11-01 convection module that was caused by an unparallelized loop. We have pushed a fix for this issue to the v11-01-Patches branch of the GEOS-Chem repository on To make sure that this fix is activated in your GEOS-Chem source code, check out the v11-01-Patches branch immediately after cloning the repository (as shown above).

You can download as many copies of the GEOS-Chem source code as you wish. For example, you might want to keep a clean v11-01 source code directory and then have one or more v11-01 source code directories that you use for development or debugging. Alternatively, you may use Git version control to keep all of your work in different branches of a single clone of the repository. For detailed information about Git and downloading the GEOS-Chem source code, please visit the following GEOS-Chem wiki pages:

If you wish to obtain an earlier version of GEOS-Chem, such as v10-01, please see the Reverting to an older state of the code wiki post.

Previous | Next | Printable View (no frames)