Skip to content

GEOS_CTM_UserGuide

JulesKouatchou edited this page Aug 8, 2022 · 40 revisions

GEOS-5 Chemistry Transport Model User's Guide

Abstract

The Goddard Earth Observing System version 5 (GEOS-5) General Circulation Model (GCM) makes use of the Earth System Modeling Framework (ESMF) to enable model configurations with many functions. One of the options of the GEOS-5 GCM is the GEOS-5 Chemistry Transport Model (GEOS-5 CTM), which is an offline simulation of chemistry and constituent transport driven by a specified meteorology and other model output fields. This document describes the basic components of the GEOS-5 CTM, and is a user's guide on to how to obtain and run simulations on the NCCS Discover platform. In addition, we provide information on how to change the model configuration input files to meet users' needs.

1 Background

The GEOS-5 Chemistry Transport Model (CTM) integrates one configurable CTM with options for running any chemistry module currently available within the GEOS-5 GCM code base. It uses the GEOS-5 Earth System Modeling Framework (ESMF) infrastructure (MAPL, the History component and the ExtData component) and the GEOS-5 advection component (AdvCore) to drive the GEOS-5 Chemistry component (that includes options for the Global Modeling Initiative (GMI) [Logan et al., 2003], the Global Ozone Chemistry Aerosol Radiation and Transport (GOCART) [Chin et al., 2000], GEOS-Chem [Bey et al., 2001], etc.). Detailed information about the GEOS-5 CTM is available in [Kouatchou et al., 2015][Kouatchou et al., 2017].

The main components of GEOS-5 CTM are:

  • AdvCore: the transport component which source code is part of the GEOS-5 directory @FVdycoreCubed_GridComp/.
  • Chemistry: the GEOS-5 Chemistry component which contains all the options for chemistry models available in GEOS-5 GCM, such as TR, GOCART, GMI, GEOS-Chem, etc. The entire GEOS-5 @GEOSchem_GridComp/ defines this component.
  • GEOS-5 CTM Cinderella Component(CC): Its primarily role is to provide services to all the other components in the CTM. It is used to derive needed fields that are not directly available in external data files. For instance, it will read the pressure and the winds to compute the mass fluxes and courant numbers required by AdvCore.
  • CTM Hist: works along with the Cinderella component to only derive fields for HISTORY.
  • Diffusion: uses Eddy mixing coefficients and SFC concentration of constituents to do an implicit diffusion calculation that conserves constituent masses during mixing.
  • Convection: uses information about the behavior of the moist process to perform convective transport and scavenging. Two main options are available in the Convection component: (1) Convective transport only for non-GMI Chemistry modules. (2) Convective transport combined with scavenging for GMI only.
  • Idealized Passive Tracer: is used to test how ell AdvCore transports tracers, especially how the mass of each tracer is conserved over time.

Remark: Because of its nature, CC (and also the CTM Hist) is the only component that can be subject to code changes as result of the addition of new components, the use of a new set of meteorological data, etc.

The role of the Parent Component (PC) is to combine all the different components, to define how components and data are connected to each other and to establish the order they are called (both during the initialization and time stepping procedures). The PC does not any knowledge of what individual components do internally. The figure below shows a basic flowchart of GEOS-5 CTM with all its major components.

The source of code for GEOS-5 CTM is maintained in a Git repository that is shared with the GEOS-5 code. In fact, GEOS-5 CTM is a Git module (can be seen as a symbolic name for sets of files or it is generally a symbolic name for a particular directory in the repository) of the entire GEOS-5 repository. Any changes made in the components (owned by GEOS-5), are automatically available to GEOS-5 CTM through the repository.


2 Obtaining the Code

Initial Steps

Before you start manipulating the CTM code, you need to load the necessary modules:

   module use -a /discover/Swede/gmao_SIteam/modulefiles-SLES12
   module load GEOSenv

which make available the latest git, CMake, and mepo modules.

Cloning the CTM Code

To have a list of available releases of the code, go to [https://github.com/GEOS-ESM/GEOSctm/releases][https://github.com/GEOS-ESM/GEOSctm/releases).

As example, to get release v2.2.1, issue the command:

    git clone -b v2.1.1 git@github.com:GEOS-ESM/GEOSctm.git

You will get the directory GEOSctm/ that contains:

    CMakeLists.txt     CODE_OF_CONDUCT.md  config/          COPYRIGHT  LICENSE-NOSA        README.md
    CMakePresets.json  components.yaml     CONTRIBUTING.md  LICENSE    parallel_build.csh  src/

If we zoom in src/, we will have the basic directory structure:

    src/
    src/Applications
    src/Applications/GEOSctm_App/
    src/Components/
    src/Components/GEOSctm_GridComp/
    src/Components/GEOSctm_GridComp/CTMconvection_GridComp/
    src/Components/GEOSctm_GridComp/CTMdiffusion_GridComp/
    src/Components/GEOSctm_GridComp/CTMpTracers_GridComp/
    src/Shared/

At this stage, the Shared/ directory is empty and the GEOSctm_GridComp/ folder only has components specific to the CTM (Cinderella, Idealized Passive Tracer, Convection and Diffusion). In the next section, we will also obtain the external components (Chemistry, Advection, etc.) required to compile and run the CTM code.

Checkout the External Components

To be able to compile and run the CTM code, we need to checkout components that are not specific or unique to the CTM.

From within GEOSctm, type:

    mepo clone

and the following components will be added (all of them starting with @):

    @env/
    @cmake/
    src/Shared/@FMS/
    src/Shared/@GMAO_Shared/
    src/Shared/@MAPL/
    src/Components/GEOSctm_GridComp/@FVdycoreCubed_GridComp/
    src/Components/GEOSctm_GridComp/@GEOSchem_GridComp/

3 Compiling the Code

From the GEOSctm/ directory, issue the commands:

    source @env/g5_modules
    mkdir build
    cd build
    cmake .. -DBASEDIR=$BASEDIR/Linux -DCMAKE_Fortran_COMPILER=ifort -DCMAKE_INSTALL_PREFIX=../install
    make -j4 install

If everything goes well, the executable GEOSctm.x will be in the directory GEOSctm/install/bin/.

In case you want to compile the code in debugging mode, the cmake command should be:

    cmake .. -DBASEDIR=$BASEDIR/Linux -DCMAKE_Fortran_COMPILER=ifort -DCMAKE_INSTALL_PREFIX=../install -DCMAKE_BUILD_TYPE=Debug

For other compilation options, please visit GEOS-ESM/GEOSctm.


4 Running the Code

4.1 Creating an Experiment Directory

In order to run a GEOS-5 CTM experiment, we recommend that you always execute the "setup" script that has a suite of default configurations. Go to the directory GEOSctm/install/bin/ and type:

    ./ctm_setup

You will answer a series of questions to determine the model configuration (horizontal resolution, type of Chemistry, driving dataset, etc.) you are interested in. The table below shows the possible configuration options.

Name Available Options
Horizontal Resolution (deg) 8, 4, 2, 1, 1/2, 1/4, 1/8, 1/16
Chemistry Passive Tracer, GOCART, GMI, Idealized Passive Tracer
Driving Dataset MERRA2, FP

The script will automatically generate configuration files and run scripts. An experiment directory (which name and location you provided in the previous step) is created and contains:

    CAP.rc:                 file containing information on start date & time,
                            end date & time of job segment, duration of job
                            segment, stop date & time of entire experiment.
    HISTORY.rc:             file for selecting the type of diagnostics to be produced
    ctm_run.j:              SLURM script for submitting the job
    RC/                     contains all the resource files needed to drive the model
    CTM_GridComp.rc:        file for turning on/off Convection, Diffusion  
                            and for selecting the type of meteorological 
                            driving (MERRA2 or FP) 
    GEOSCTM.rc:             file for setting model parameters
    MAPL_ExtData.rc:        file needed by ExtData to read external data files

4.2 Running your Experiment

You need to go to your experiment directory and first create the file:

    cap_restart:            ASCII file containing (single line) starting the
                            date (YYYYMMDD) and time (HHMMSS) of the job segment
                            in the format: YYYYMMDD HHMMSS

You will also need to obtain a restart file from a previous CTM or CCM experiment. This is a requirement if you plan to run any Chemistry configuration (TR, GOCART, GMI).

Before issuing the command:

    sbatch ctm_run.j

you may want to edit few files (see next section) to select additional options for your experiment.

Remark: When you run the ctm_setup script, the template files MERRA2_ExtData.rc.tmpl FP_ExtData.rc.tmpl are generated. At run time, the SLURM script ctm_run.j manipulates one of them (based on the initial settings) to create a file similar to MAPL_ExtData.rc.


5 Changing Default Configuration

5.1 CTM_GridComp.rc File

The CTM_GridComp.rc file is used to set options for Convection, Diffusion and the type meteorological data.

Meteorological Data

We need to set the variable metType that has two options:

  • MERRA2 (default): data files available from 1979 to present.
  • FP: data files available from February 2014 to present.

If you need to use the FP forcing data file...

Convection

By default, Convection is activated all configurations but not the Idealized Passive Trace configuration (where Convection is not needed). For the GMI Chemistry, we have the setting:

      do_ctmConvection: T
            convecType: 2  

For the other configurations, we have:

      do_ctmConvection: T
            convecType: 1  # convective transport only

Diffusion

By default, Duffusion is activated all configurations but Idealized Passive Tracer. In case we want to exercise Diffusion, we need to set:

      do_ctmDiffusion: T

Reading the Pressure Field from External Data Files

In earlier versions of the code, the atmospheric 3D pressure (PLE) was read in (by default) from external data files. The code was modified to allow the reading of the surface pressure (PS) instead and PLE is calculated using PS and the AKs and BKs. If users still want to read PLE, they need ro set:

    read_PLE: T

Turning Off Advection

By default, Advection is always turned on regardless of the configuration used. If you do not want to exercise the Advection component, use the setting:

    do_ctmAdvection: F

Reading Courant Numbers and Mass Fluxes for Advection

By default, the courant numbers (CX & CY) and the mass fluxes (MFX & MFY) are calculated by the CTM Cinderella component using the wind fields and the 3D pressure. There is also an option to read in CX, CY, MFX & MFY from forcing data files. You following setting is needed:

    read_advCoreFields: T

By default, it is assumed that the CX, CY, MFX & MFY are in the lat-lon grid. If they are instead in the cubed-sphere grid, the surface pressure (PS) and the specific humidity (Q) also need to be read in the cubed-sphere grid. This setting has been tested using the GEOS FP forcing data where the ExtData template file included:

CX          '1'              N        N           0                 0.0      1.0     CX           /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.tavg_1hr_ctm_c0720_v72.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:30:00P01:00
CY          '1'              N        N           0                 0.0      1.0     CY           /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.tavg_1hr_ctm_c0720_v72.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:30:00P01:00
MFX         'Pa m+2 s-1'     N        N           0                 0.0      1.0     MFXC         /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.tavg_1hr_ctm_c0720_v72.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:30:00P01:00
MFY         'Pa m+2 s-1'     N        N           0                 0.0      1.0     MFYC         /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.tavg_1hr_ctm_c0720_v72.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:30:00P01:00

PS          'Pa'             N        N           0                 0.0      1.0     PS           /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.inst_1hr_ctm_c0720_v72.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:00:00P01:00
PS0         'Pa'             N        N           0                 0.0      1.0     PS           /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.inst_1hr_ctm_c0720_v72.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:00:00P01:00
PS1         'Pa'             N        N           0;730             0.0      1.0     PS           /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.inst_1hr_ctm_c0720_v72.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:00:00P01:00
Q           'kg kg-1'        N        N           0                 0.0      1.0     QV           /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.inst_1hr_ctm_c0720_v72.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:00:00P01:00

5.2 Duration of Experiment

In the process of generating the configuration scripts, the following files were created:

  • CAP.rc: contains begin/end date and time of entire job, stop date, duration (in days) of each job segment.
  • ctm_run.j: SLURM script

Assume that we want to carry out a 12-month experiment with January 1, 2005 as starting date. We want to run one month at the time. The file cap_restart will have

    20050101 000000

and the file CAP.rc will have the settings:

    BEG_DATE: 20000101 000000
    END_DATE: 20060101 000000
    JOB_SGMT: 00000100 000000

Note that the stop date END_DATE is January 1, 2006. We will need to submit the PBS script:

    sbatch ctm_run.j

When the first job segment is completed (for January 2005), the script will resubmit itself. The file cap_restart will automatically be updated to contain:

    20050201 000000

5.3 ExtData Component

GEOS-5 contains the Gridded Component ExtData that has the ability to read from external files variables needed by the model. ExtData

  • Relies on a resource file that lists the variables to be read in. Each variable is represented with the following information: short name, dimension, unit, path to netCDF/hdf file containing the variable, variable name in the file, reading frequency, etc.
  • Can perform unit conversion. It has basic scaling and offset calculations.
  • Does time interpolation.
  • Does vertical interpolation.
  • Does on the fly regridding.
  • Is called at every time step before all the other run methods (Physics, Dynamics).
  • Is the last ESMF gridded component the entire code will rely on to look for the availability of a given variable (requested by another ESMF gridded component). If the variable cannot be provided, the code will abort.

Files with Multiple Records

PrimaryExports%%
# ---------|-------------|-------|--------|----------------------|--------|--------|-------------|----------|
#  Import  |             |       | Regrid |        Refresh       | OffSet | Scale  | Variable On |   File   |
#  Name    |    Units    | Clim  | Method |     Time Template    | Factor | Factor |     File    | Template |
# ---------|-------------|-------|--------|----------------------|--------|--------|-------------|----------|
SLP         'Pa'             N        N           0                 0.0      1.0     SLP          /discover/nobackup/projects/gmao/merra2/data/products/d5124_m2_@sMonth/Y%y4/M%m2/@MERRA2type.tavg1_2d_slv_Nx.%y4%m2%d2.nc4
T           'K'              N        N           0                 0.0      1.0     T            /discover/nobackup/projects/gmao/merra2/data/products/d5124_m2_@sMonth/Y%y4/M%m2/@MERRA2type.inst3_3d_asm_Nv.%y4%m2%d2.nc4
PS          'Pa'             N        N           0                 0.0      1.0     PS           /discover/nobackup/projects/gmao/merra2/data/products/d5124_m2_@sMonth/Y%y4/M%m2/@MERRA2type.tavg1_2d_slv_Nx.%y4%m2%d2.nc4
UC0;VC0     'm s-1'          N        N           0                 0.0      1.0     U;V           /discover/nobackup/projects/gmao/merra2/data/products/d5124_m2_@sMonth/Y%y4/M%m2/@MERRA2type.inst3_3d_asm_Nv.%y4%m2%d2.nc4
UC1;VC1     'm s-1'          N        N           0;730             0.0      1.0     U;V          /discover/nobackup/projects/gmao/merra2/data/products/d5124_m2_@sMonth/Y%y4/M%m2/@MERRA2type.inst3_3d_asm_Nv.%y4%m2%d2.nc4

We want to make few remarks above settings:

  • The notation UC0;VC0 states that the fields UC0 and VC0 are regridded together as a vector where UC0 represents the tangential component in the longitudinal direction. The two fields are transformed to a cartesian vector, each component of the cartesian vector is regridded as a scalar and the resulting vector is transformed back to the tangential components on the sphere.
  • The 0;730 in the Refresh Time Template section means that the field will be read at current time plus 7 minutes and 30 seconds. ExtData will automatically perform the time interpolation. This setting is mainly used fields needed by AdvCore. It is important to note that 7 minutes and 30 seconds corresponds to the model time step.

Files with One Time Record

This option applies to FP data files

PrimaryExports%%
# ---------|-------------|-------|--------|----------------------|--------|--------|-------------|----------|
#  Import  |             |       | Regrid |        Refresh       | OffSet | Scale  | Variable On |   File   |
#  Name    |    Units    | Clim  | Method |     Time Template    | Factor | Factor |     File    | Template |
# ---------|-------------|-------|--------|----------------------|--------|--------|-------------|----------|
SLP         'Pa'             N        N           0                 0.0      1.0     SLP          /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.tavg1_2d_slv_Nx.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:30:00P01:00
T           'K'              N        N           0                 0.0      1.0     T             /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.inst3_3d_asm_Nv.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:00:00P03:00
PS          'Pa'             N        N           0                 0.0      1.0     PS           /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.inst3_3d_asm_Nv.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:00:00P03:00
UC0;VC0     'm s-1'          N        N           0                 0.0      1.0     U;V          /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.inst3_3d_asm_Nv.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:00:00P03:00
UC1;VC1     'm s-1'          N        N           0;730             0.0      1.0     U;V          /gpfsm/dnb04/projects/p14/pub/fp/das/Y%y4/M%m2/D%d2/GEOS.fp.asm.inst3_3d_asm_Nv.%y4%m2%d2_%h2%n2.V01.nc4 2015-01-01T00:00:00P03:00

5.4 Outputting Variables

Component Names

The model outputs are controlled through a resource file named HISTORY.rc. To produce a field, it is important to know the acronym of the component which owns it. The table below lists the main component names and their acronyms.

Component Name Name in HISTORY.rc
GEOS-5 CTM Cinderella CTMenv
CTM History CTMhist
GEOSchem Cinderella CHEMENV
Passive Tracer TR
Idealized Passive Tracer pTracers
GOCART Chemistry GOCART
GMI Chemistry GMICHEM
Convection CONVECTION
Diffusion DIFFUSION

Settings for Overpass Outputs

The Overpass diagnostics (at 10 am and 2 pm) are created in the GEOSchem Cinderella component. The available fields are:

Short Names Long Names
OVP10_AIRDENS moist_air_density_10am_local (kg m-3)
OVP14_AIRDENS moist_air_density_2pm_local (kg m-3)
OVP10_T air_temperature_10am_local (K)
OVP14_T air_temperature_2pm_local (K)
OVP10_PL mid_level_pressure_10am_local (Pa)
OVP14_PL mid_level_pressure_2pm_local (Pa)
OVP10_PLE edge_pressure_10am_local (Pa)
OVP14_PLE edge_pressure_2pm_local (Pa)
OVP10_QV_VMR water_vapor_10am_local (mol mol-1)
OVP14_QV_VMR water_vapor_2pm_local (mol mol-1)
OVP10_QLTOT mass_fraction_of_cloud_liquid_water_10am_local (kg kg-1)
OVP14_QLTOT mass_fraction_of_cloud_liquid_water_2pm_local (kg kg-1)
OVP10_PS surface_pressure_10am_local (Pa)
OVP14_PS surface_pressure_2pm_local (Pa)
OVP10_PPBL pbltop_pressure_10am_local (Pa)
OVP14_PPBL pbltop_pressure_2pm_local (Pa)
OVP10_TROPP tropopause_pressure_10am_local (Pa)
OVP14_TROPP tropopause_pressure_2pm_local (Pa)
OVP10_U10M eastward_10m_wind_speed_10am_local (m s-1)
OVP14_U10M eastward_10m_wind_speed_2pm_local (m s-1)
OVP10_V10M northward_10m_wind_speed_10am_local (m s-1)
OVP14_V10M northward_10m_wind_speed_2pm_local (m s-1)

A sample setting in the HISTORY.rc file is:

   ovpC.template:   '%y4%m2%d2_%h2%n2z.nc4',
   ovpC.archive:    '%c/Y%y4',
   ovpC.format:     'CFIO',
   ovpC.mode:       'instantaneous',
   ovpC.frequency:  240000,
   ovpC.duration:   240000,
   ovpC.ref_time:   000000,
   ovpC.resolution: 180 91,
   ovpC.fields:       'OVP10_PS'          , 'CHEMENV'      ,
                      'OVP10_T'           , 'CHEMENV'      ,
                      'OVP10_PL'          , 'CHEMENV'      ,
                      'OVP10_U10M'        , 'CHEMENV'      ,
                      'OVP10_V10M'        , 'CHEMENV'      ,
                      'OVP10_TROPP'       , 'CHEMENV'      ,
                      'OVP10_QLTOT'       , 'CHEMENV'      ,
                      'OVP10_PPBL'        , 'CHEMENV'      ,
                      'OVP10_QV_VMR'      , 'CHEMENV'      ,
                    ::

Settings for Budget Outputs

The CTM code can produce tendencies for Advection (TRADVI), Diffusion (TRI) and Convection (MTRI). You can output the tendencies of the fields friendly to those components.

  conv_tendency.template:   '%y4%m2%d2_%h2%n2z.nc4',
  conv_tendency.archive:    '%c/Y%y4',
  conv_tendency.format:     'CFIO',
  conv_tendency.mode:       'instantaneous',
  conv_tendency.frequency:  010000,
  conv_tendency.duration:   240000,
  conv_tendency.ref_time:   000000,
  conv_tendency.resolution: 180 91,
  conv_tendency.fields:  'MTRI%GOCART::CO2IM'         , 'GEOSctm'      , 'CO2_MOISTTEND',
                         'MTRI%GOCART::COIM'          , 'GEOSctm'      , 'CO_MOISTTEND',
               ::

  diff_tendency.template:   '%y4%m2%d2_%h2%n2z.nc4',
  diff_tendency.archive:    '%c/Y%y4',
  diff_tendency.format:     'CFIO',
  diff_tendency.mode:       'instantaneous',
  diff_tendency.frequency:  010000,
  diff_tendency.duration:   240000,
  diff_tendency.ref_time:   000000,
  diff_tendency.resolution: 180 91,
  diff_tendency.fields:  'TRI%GOCART::CO2IT'         , 'GEOSctm'      , 'CO2_TURBTEND',
                         'TRI%GOCART::COIT'          , 'GEOSctm'      , 'CO_TURBTEND',
               ::

  adv_tendency.template:   '%y4%m2%d2_%h2%n2z.nc4',
  adv_tendency.archive:    '%c/Y%y4',
  adv_tendency.format:     'CFIO',
  adv_tendency.mode:       'instantaneous',
  adv_tendency.frequency:  010000,
  adv_tendency.duration:   240000,
  adv_tendency.ref_time:   000000,
  adv_tendency.resolution: 180 91,
  adv_tendency.fields:  'TRADVI%GOCART::CO2ID'         , 'GEOSctm'      , 'CO2_ADVTEND',
                        'TRADVI%GOCART::COID'          , 'GEOSctm'      , 'CO_ADVTEND',
               ::

5.5 Running with RAS Calculations

When the setting:

    enable_rasCalculations: T

is available in the CTM_GridComp.rc file, the CTM Cinderella component will compute (using the RAS module) the convective mass fluxes and pass them to the Convective components.

5.6 Running using Forcing Data Files on CS Grid

As we stated earlier, by default the code expects all the data files to be in the lat-lon grid. However, we have made experiments (using the FP data files) where CX, CY, MFX & MFY were in the cubed-sphere grid. In such experiments, the surface pressure (PS) and the specific humidity (Q) were also on the cubed-sphere grid whereas all the other fields remained in the lat-lon grid. It is required to have the following setting in the CTM_GridComp.rc file:

    read_advCoreFields: T

6 Making Changes to the Code

If you need to make changes to the code, we recommend that you first create a feature branch, immediately after checking out the code:

git checkout -b feature_branch_name

after making your changes and committing them to your local feature branch repository, you can push them to the remote feature branch repository:

git push --set-upstream origin feature_branch_name

Bibliography

[Bey et al., 2001] Bey, I., Jacob, D. J., M.Yantosca, R., Logan, J. A., Filed, B. D., Fiore, A. M., Li, Q., Liu, H. Y., Mickley, L. J., and Schiltz, M. G. (2001). Global modeling of tropospheric chemistry with assimilated meteorology: Model description and evaluation,. J. Geophys. Res., 106:23073–23095.

[Chin et al., 2000] Chin, M., Rood, R. B., Lin, S.-J., Muller, J., and Thompson, A. (2000). Atmospheric sulfur cycle simulated in the global model GOCART: model description and global properties. J. Geophys. Res., 105:24671–24687.

[Kouatchou et al., 2015] Kouatchou, J., A. Molod, J. E. Nielsen, B. Auer, W. Putman and T. Clune (2015). GEOS-5 Chemistry Transport Model User’s Guide. GMAO Office Note No. 8 (Version 1.0), 26 pp.

[Kouatchou et al., 2017] Kouatchou, J., T. Clune, B. Auer, J. E. Nielsen and A. Molod (2017) Parallel performance analysis of two infrastructure frameworks for GMI chemistry, American Meteorological Society’s Third Symposium on High Performance Computing for Weather, Water, and Climate.

[Logan et al., 2003] Logan, J. A., Bergmann, D., Rodriguez, J., Chatfield, R., Considine, D., Wang, Y., Jacob, D., Prather, M., Rotman, D., and Cameron-Smith, P. (2003). Evaluation of tropo- spheric chemistry simulations for the Global Modeling Initiative (GMI). Geophysical Research Abstracts, 5.