Cloning (i.e. downloading for the first time)
On this page, we describe how to download (aka "clone") the GEOS-Chem source code with Git.
Cloning the current GEOS-Chem version
The GEOS-Chem source code repository is available for remote download via Git, from our Github repository:
The first time that you will download a new GEOS-Chem version to your disk space, you must use the git clone command. This will create an exact copy of the GEOS-Chem source code (including the complete version control history) to a folder on your disk.
To clone the current version of GEOS-Chem, type:
git clone https://github.com/geoschem/geos-chem.git LOCAL_DIR_NAME
where LOCAL-DIR-NAME is the name of the local directory on your disk into which the GEOS-Chem source code files will be placed. It is up to you to pick LOCAL-DIR-NAME.
The GEOS-Chem source code that you downloaded will be a copy of the master branch, which always points to the current stable GEOS-Chem version. (More about Git branches in a couple of chapters.)
Cloning an older GEOS-Chem version
You can also clone an older GEOS-Chem version by using the -b option with git clone. This will copy the GEOS-Chem source code to your folder, and point the code to the branch' or the tag that you specify. (More about branches and tags in a few chapters).
For example, to clone a copy of the GEOS-Chem 12.0.0 code, type:
git clone -b 12.0.0 https://github.com/geoschem/geos-chem.git LOCAL_DIR_NAME git checkout 12.0.0
This will download the GEOS-Chem source code and point you to the state of the code corresponding to the GEOS-Chem 12.0.0 release.
- The git clone command (Official Git documentation)
- Git basics: Getting a Git repository (Pro Git book)
- Git clone (Atlassian Git tutorial)