GEOS-Chem Online User's Guide

Previous | Next | Printable View (no frames)

GEOS-Chem v11-02-final will also carry the designation GEOS-Chem 12.0.0. We are migrating to a purely numeric versioning system in order to adhere more closely to software development best practices. For a complete description of the new versioning system, please see our GEOS-Chem version numbering system wiki page.

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.

IMPORTANT NOTE! As of June 2018, we have migrated the GEOS-Chem source code repository from Bitbucket back to Github. Going forward, please make sure to clone or pull code updates ONLY from the Github repository. Using Github will allow us to define a DOI for each GEOS-Chem major version.

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 stable version of GEOS-Chem (currently 12.0.0) by means of the git clone command by typing the following at the command line:

git clone Code.12.0.0
cd Code.12.0.0

git checkout master

NOTE: We recommend using the current version number (i.e. 12.0.0) in the code-directory name.

This will create an exact copy (or clone) of the official GEOS-Chem repository to your local disk space in a directory named Code.GC12. Using Code.GC12 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.

You can download as many copies of the GEOS-Chem source code as you wish. For example, you might want to keep a clean source code directory and then have one or more 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 v11-01, please see the Reverting to an older state of the code wiki post.

Previous | Next | Printable View (no frames)