Difference between revisions of "Cloning (i.e. downloading for the first time)"

From Geos-chem
Jump to: navigation, search
(Cloning an older GEOS-Chem version)
Line 25: Line 25:
 
== Cloning an older GEOS-Chem version ==
 
== Cloning an older GEOS-Chem version ==
  
You can also clone an older GEOS-Chem version by using the <tt>-b</tt> option with <tt>git clone</tt>.  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).
+
You can also clone an older GEOS-Chem version by using the <tt>-b</tt> option with <tt>git clone</tt>.  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:
 
For example, to clone a copy of the GEOS-Chem 12.0.0 code, type:

Revision as of 15:14, 19 June 2019

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