View source for Downloading GEOS-Chem source code (12.9.3 and earlier versions)

__FORCETOC__
'''''[[Downloading GEOS-Chem source code (13.0.0 and later versions)|Previous]] | [[GEOS-Chem directory structure|Next]] | [[Getting Started with GEOS-Chem]]'''''
#[[Minimum system requirements for GEOS-Chem|Minimum system requirements]]
#[[Installing required software]]
#[[Configuring your computational environment]]
#[[Downloading GEOS-Chem source code|Downloading source code]]
#*[[Downloading GEOS-Chem source code (13.0.0 and later versions)|... for GEOS-Chem 13.0.0 and later versions]]
#*<span style="color:blue">'''... for GEOS-Chem 12.9.3 and earlier versions'''</span>
#*[[GEOS-Chem directory structure]]
#[[Downloading GEOS-Chem data directories|Downloading data directories]]
#[[Creating GEOS-Chem run directories|Creating run directories]]
#[[GEOS-Chem configuration files|Configuring runs]]
#[[Compiling GEOS-Chem|Compiling]]
#[[Running GEOS-Chem|Running]]
#[[GEOS-Chem output files|Output files]]
#[[Guide_to_visualization_and_analysis_tools_for_GEOS-Chem|Visualizing and processing output]]
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
#[[GEOS-Chem_overview#Further_reading|Further reading]]


== Overview ==

The GEOS-Chem source code is maintained on Github.com at '''https://github.com/geoschem/geos-chem'''. All [https://github.com/geoschem/geos-chem/releases official GEOS-Chem releases] shall originate from that Git repository.

We also recommend that you view this video tutorial, which is posted at our GEOS_Chem Youtube channel: [http://youtube.geos-chem.org '''youtube.geos-chem.org''']:

{| border="1" cellspacing=0 cellpadding=5 
|-valign="top" align="center"
|[[Image:Getting_Started_with_GC_Thumbnail.png]]<br> [https://www.youtube.com/watch?v=LOobuuhNdAg '''<big>Click HERE to view</big>'''!]
|}

== Download GEOS-Chem ==

You can download the [[GEOS-Chem_12#Current_stable_version|latest stable version of GEOS-Chem]] by typing the following at the command line:

  git clone https://github.com/geoschem/geos-chem Code.X.Y.Z

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. You may name the code directory whatever you like, but we recommend using the [[GEOS-Chem_versions|version number]] (i.e. X.Y.Z) in the code directory name. For more information on the meaning of X.Y.Z, see our [[GEOS-Chem version numbering system]] page.

===Note for advanced users===

If you plan on developing GEOS-Chem updates to submit for inclusion in the standard model we recommend that you [https://help.github.com/articles/fork-a-repo/ fork the repository] on Github and clone it from your own account. You can then make a [https://help.github.com/articles/creating-a-pull-request/ pull request] when you are ready to submit updates to the [[GEOS-Chem Support Team]]. See [[Submitting_updates_for_inclusion_in_GEOS-Chem|these instructions]] for more information.

== Choosing a different version ==

When you clone GEOS-Chem you will always get the master branch. This is the [[GEOS-Chem_12#Current_stable_version|current stable version of GEOS-Chem]].  You can determine the version label by typing <tt>git log --decorate</tt> within each repository and looking at the git tag string printed for the top-most commit. 

[[File:gchp Gittag.png|800px|thumb|Example output of git log. Notice tag name at top indicating what version this is.]]

If you would like an earlier version you can checkout the version tag for that specific version. To see a list of available tags for a repository type <tt>git tag</tt>. To checkout a tagged version type <tt>git checkout -b NewBranch tags/tagname</tt>, where NewBranch can be a name of your choosing.

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.

== Code directory structure ==

You may now skip ahead to the [[GEOS-Chem directory structure]] chapter.

== Further reading ==

* ''[[Guide to using Git with GEOS-Chem]]''
* Git website: http://www.git-scm.com/


----
'''''[[Downloading GEOS-Chem source code (13.0.0 and later versions)|Previous]] | [[GEOS-Chem directory structure|Next]] | [[Getting Started with GEOS-Chem]]'''''