Getting started

This tutorial will guide you through the process of accessing and using the GEOS-Chem Input Data on AWS. The workflow is

Install and configure AWS CLI
Access and download data
Follow the normal GEOS-Chem User Guide to use the data or running GCHP on AWS

Install and configure AWS CLI

If you have already installed and configured the AWS CLI previously, continue to Accessing and download data.

Step 1: Install AWS CLI

Follow the instructions to install the AWS CLI from the AWS CLI User Guide.

Step 2: Configure AWS CLI

Run the following command to configure AWS CLI with your credentials:

$ aws configure

For instructions on aws configure, refer to the Configure the AWS CLI .

Accessing and download data

Step 1: List available data

To view the available data in the GEOS-Chem Input Data S3 bucket, use the following command:

$ aws s3 ls s3://<resource_name>/

or without AWS account required

$ aws s3 ls --no-sign-request s3://<resource_name>/

Step 2: Navigate through the directories

You can navigate through the directories to find the specific data you need. For example,

aws s3 ls s3://<resource_name>/ExtData/GEOS_0.5x0.625/MERRA2/2024/05

Step 3: Download the data

Once you have located the data you need, you can download it to your local cluster or an EC2 instance. For example,

aws s3 cp s3://<resource_name>/ExtData/GEOS_0.5x0.625/MERRA2/2024/05 ./ --recursive

This command will copy the data to your current path.

Using the data in GEOS-Chem

By following this tutorial, you can access and download the GEOS-Chem Input Data on AWS. Next, you can follow the normal GEOS-Chem Classic or GCHP user guide to use the data.

Running GCHP on AWS

If you want to use the computing resources on AWS to run GCHP and are seeking for an AMI, feel free to check Set up AWS ParallelCluster.