GEOS-Chem 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 Github.com:

https://github.com/geoschem/geos-chem

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 https://github.com/geoschem/geos-chem Code.X.Y.Z
cd Code.X.Y.Z

git checkout master

NOTE: We recommend using the current version number (i.e. X.Y.Z) in the code-directory name. For more information about what the digits in the GEOS-Chem version number mean, please follow this link.

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

You will also need to create a GEOS-Chem run directory for the simulation(s) that you wish to perform. See Chapter 6 for more information.

Previous | Next | Printable View (no frames)