GEOS-Chem on cloud computing platforms

The GEOS-Chem on cloud computing platforms project provides fast and easy access to the latest, standard GEOS-Chem model and all its input datasets on Amazon Web Services (and perhaps in future, Google) cloud computing plaforms.

GEOS-Chem is a Chemical Transport Model for simulating atmospheric chemical compositions. It has been developed over 30 years and is used by more than 100 research groups worldwide. The program is mainly written in Fortran 90. All model source code is distributed freely under the MIT license. GEOS-Chem reads and writes data in the netCDF data format, which can be analyzed easily by most languages such as Python, R and MATLAB.

We are pleased to announce that this project is part of the AWS Open Data Sponsorship Program. As a result, GEOS-Chem input data hosted on AWS is completely free to use.

See also

This site focuses on cloud infrastructure. For comprehensive instructions on model configuration, compiling, and science updates, please refer to the other GEOS-Chem user manuals:

• GCHP Documentation

• GEOS-Chem Classic Documentation

Initial setup

• Set up and use a cloud computing account
  • Amazon Web Services (AWS)
    • Account creation
    • Setup and security
    • AWS Command Line Interface (AWSCLI)
    • Elastic Cloud Compute (EC2)
    • Billing
    • Troubleshooting and support
  • Google Cloud

GC-Classic on AWS cloud

• Run GEOS-Chem Classic on AWS EC2
  • Launch your EC2 instance
  • Connect to your instance
  • Verify the environment
  • Download the GC-Classic source code and data

GCHP on AWS cloud

• Quickstart I: Prepare Your AWS Environment
  • 1. IAM Permissions for Cluster Creation
    • Scenario A: You Manage Your Own AWS Account
    • Scenario B: You Belong to a University or Corporate Account
  • 2. AWS Service Quotas (vCPU Limits)
    • How to calculate what you need
    • How to request a quota increase
  • 3. Node.js Backend Requirement
    • Install Node.js
    • Verify your Node.js installation
• Quickstart II: Set up AWS ParallelCluster
  • Workflow
  • 1. Create an FSx for Lustre file system
  • 2. AWS CLI Installation and First-Time Setup
  • 3. Configure your AWS ParallelCluster
    • 3a. Create a Key Pair
    • 3b. Install AWS ParallelCluster
    • 3c. Configure Your Cluster
    • 3d. Customize your configuration
  • 4. Create your ParallelCluster
  • 5. Running GCHP on ParallelCluster
• Reference: AWS Terminology
  • AWS ParallelCluster
    • What is AWS ParallelCluster?
    • Why Use AWS ParallelCluster for GCHP?
    • How AWS ParallelCluster Works
  • AWS CloudFormation
    • What is AWS CloudFormation?
    • Checking Cluster Status and Troubleshooting
  • IAM (Identity and Access Management)
    • 1. Your IAM User Permissions (The Builder)
    • 2. The Cluster’s IAM Roles (The Operators)
  • Amazon FSx for Lustre
    • How FSx for Lustre is Used in AWS ParallelCluster
    • Benefits for GCHP Users

Help and Reference

• Key references
• Contributing Guidelines
  • We use GitHub and ReadTheDocs
  • When should I submit updates?
  • How can I submit updates?
  • How can I request a new feature?
  • How can I report a bug?
  • Where can I ask for help?
• Support Guidelines
  • How to report a bug
  • Where can I ask for help?
  • What type of support can I expect?
  • How to submit changes
  • How to request an enhancement
• View related documentation
• Editing this User Guide
  • Quick start
  • Learning reStructured Text
  • Style guidelines