GEOS GCM Documentation and Access: Difference between revisions

From GEOS-5
Jump to navigation Jump to search
mNo edit summary
Line 1: Line 1:
This page describes the minimum steps required to checkout GEOS-5 AGCM.  
This page describes the minimum steps required to checkout GEOS AGCM.  


== Checking Out GEOS-5 AGCM using subversion ==
'''NOTE NOTE NOTE:''' This is only to get the '''code''' for the GEOS AGCM. If you wish to use the production output from GEOS as run at the GMAO, please refer to the [https://gmao.gsfc.nasa.gov/GMAO_products/ GMAO page on GEOS products].
 
== Checking Out GEOS AGCM using subversion ==


The commands below assume that you have a svn client installed on your machine.  
The commands below assume that you have a svn client installed on your machine.  


The first thing you need to do is to register in the GEOS5 trac system using the following link:
The first thing you need to do is to register in the GEOS trac system using the following link:
   
   
  https://geos5.org/trac
  https://geos5.org/trac
Line 17: Line 19:
You can create tickets through the trac system and contribute to the code.
You can create tickets through the trac system and contribute to the code.


== Building GEOS-5 ==
== Building GEOS ==


'''NOTE:''' GMAO does '''not''' generally support building or running GEOS on systems other than on NASA Supercomputers. This code access is provided mainly for collaborators with GMAO who are unable to gain access to the GMAO internal version control system.
'''NOTE:''' GMAO does '''not''' generally support building or running GEOS on systems other than on NASA Supercomputers. This code access is provided mainly for collaborators with GMAO who are unable to gain access to the GMAO internal version control system.

Revision as of 09:07, 3 November 2017

This page describes the minimum steps required to checkout GEOS AGCM.

NOTE NOTE NOTE: This is only to get the code for the GEOS AGCM. If you wish to use the production output from GEOS as run at the GMAO, please refer to the GMAO page on GEOS products.

Checking Out GEOS AGCM using subversion

The commands below assume that you have a svn client installed on your machine.

The first thing you need to do is to register in the GEOS trac system using the following link:

https://geos5.org/trac

In order to access the SVN repository as a developer, you need to be approved by the GEOS5 AGCM maintainer at the following email address: matthew.thompson@nasa.gov

Once approved, you will be able to checkout the source code with the following command:

svn --username username checkout https://geos5.org/svn/branches/Icarus-2_0/ GEOSagcm

You can create tickets through the trac system and contribute to the code.

Building GEOS

NOTE: GMAO does not generally support building or running GEOS on systems other than on NASA Supercomputers. This code access is provided mainly for collaborators with GMAO who are unable to gain access to the GMAO internal version control system.

GEOS-5 AGCM can be built, but you will need a variety of programs. An F90 compiler (Intel, PGI, and GCC are tested) and an MPI stack (Open MPI, Intel MPI, MVAPICH2, and SGI MPT have been tested). Beyond that, you'll also need the GMAO Baselibs, a collection of base libraries for GEOS-5 which include HDF5, netCDF-C, netCDF-Fortran, ESMF, and more. Note that while these can be built individually, GEOS-5 at present expects the libraries to be bundled in a specific way (directory-wise) to work.

Boundary Conditions

Boundary conditions are available at NCCS, NAS, and on GMAO Desktops (limited to very low-res).

A minimal, small set of boundary conditions of approximately 300 MB (4-degree resolution or coarser, probably could only run a few model days) have been made and could possibly be distributed if needed. Contact Matthew Thompson for further inquiries.