Cloning (i.e. downloading for the first time)

From Geos-chem
Revision as of 15:19, 19 June 2019 by Bmy (Talk | contribs)

Jump to: navigation, search

Previous | Next | Guide to using Git with GEOS-Chem | Getting Started with GEOS-Chem | GEOS-Chem Main Page


Overview

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.

Further reading

  1. The git clone command (Official Git documentation)
  2. Git basics: Getting a Git repository (Pro Git book)
  3. Git clone (Atlassian Git tutorial)

Previous | Next | Guide to using Git with GEOS-Chem | Getting Started with GEOS-Chem | GEOS-Chem Main Page