Difference between revisions of "Coupling GEOS-Chem with RRTMG"

From Geos-chem
Jump to: navigation, search
(Authors and collaborators)
Line 1: Line 1:
 
=== Overview ===
 
=== Overview ===
  
The GEOS-Chem model with online radiative transfer calculations (referred to as GCRT) was developed to allow GEOS-Chem users to produce gas and aerosol direct radiative effect (DRE) output. This alternative to offline coupling allows better temporal resolution in the RT calculations and provides a consist platform for GEOS-Chem users with the reliable radiative transfer package RRTMG.
+
The GEOS-Chem model with online radiative transfer calculations (referred to as GCRT) was developed to allow GEOS-Chem users to produce gas and aerosol direct radiative effect (DRE) output. This alternative to offline coupling allows better temporal resolution in the RT calculations and provides a consist platform for GEOS-Chem users with the widely used radiative transfer package [http://rtweb.aer.com/rrtm_frame.html RRTMG].
  
Most of the added code is 'transparent', therefore GEOS-Chem model can still be run with the radiation code switched off. The optical properties are calculated at multiple wavelengths so the user is no longer restricted to 550nm as default, or indeed a single wavelength, so there are associated changes regardless of whether the radiative code is invoked. However, these cause negligible slow down (the model is actually slightly faster).
+
Most of the added code is 'transparent', therefore this version of the GEOS-Chem model can still be run with the radiation code switched off. The optical properties are calculated at multiple wavelengths so the user is no longer restricted to 550nm as default, so there are associated changes regardless of whether the radiative code is invoked. However, these cause negligible slow down (the default model is actually slightly faster). Compiling with RRTMG=yes requires approximately double the amount of RAM (~15Gb for a 2x2.5 simulation).
 +
 
 +
This wiki explains the key changes and links to the documentation for getting started running the model and digging deeper into the changes and the auxiliary files required.
 +
 
 +
 
 +
 
 +
=== Authors and collaborators ===
 +
* [mailto:heald@mit.edu Colette Heald]  ''(Civil and Environmental Engineering, MIT)''  -- Principal Investigator
 +
* [mailto:sbarrett@mit.edu Steven Barrett] ''(Aeronautics and Astronautics, MIT)''
 +
* [mailto:ridley@mit.edu David Ridley] ''(Civil and Environmental Engineering, MIT)''
 +
* [mailto:kcadyper@aer.com Karen Cady-Pereira] ''(AER)''
 +
* [mailto:malvarad@aer.com Matthew Alvarado] ''(AER)''
 +
 
 +
 
 +
Questions regarding GCRT can be directed at David (e-mail linked above).
 +
 
 +
--[[User:David Ridley|David R.]] 18:00, 08 October 2013 (EST)
 +
 
 +
=== GCRT User Groups ===
 +
 
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|- bgcolor="#cccccc"
 +
!User Group
 +
!Personnel
 +
!Projects
 +
|-valign="top"
 +
|[http://atmoschem.mit.edu/ Atmospheric Chemistry, Massachusetts Institute of Technology]
 +
|[http://www.web.mit.edu/daridley/www/ David Ridley]<br>[http://web.mit.edu/heald/www/ Colette Heald]
 +
| [http://web.mit.edu/heald/www/publications.html GCRT Publication] <br> Xuan's work <br> Dust work
 +
 
 +
|-valign="top"
 +
|Add yours here
 +
|
 +
|
 +
|}
  
This wiki explains the key changes, why they were chosen, and links to the documentation for getting started running the model and digging deeper into the changes and the auxiliary files required.
 
  
 
=== Key Changes ===
 
=== Key Changes ===
  
1. A new menu for Radiation exists in input.geos. This also includes a wavelength selection for optical depth output (up to three optical depths, but only the first is used for diagnostics other than the standard bpch output).
+
1. A new menu for Radiation exists in input.geos (see below). This also includes a wavelength selection for optical depth output that is independent of whether RRTMG is switched on (up to three optical depths can be output in the standard OD-MAP-$ diagnostic, but only the first is used for diagnostics other than the standard bpch output e.g. ND51).
 +
 
 +
2. A new code folder, GeosRad/, is required for the RRTMG code. The module "rrtmg_rad_transfer_mod.F" is the driver code (within GeosCore/) that interfaces with RRTMG.
 +
 
 +
3. The optics look-up tables are updated, containing multiple wavelengths and separated into files for each species (soot.dat, so4.dat, org.dat, dust.dat, ssa.dat, ssc.dat) that are stored in the run directory. To prevent discrepancies jv_spec.dat no longer contains optical properties for aerosol, Fast-J uses optics from from the same speciated look-up tables. The new files mean that jv_spec_aod.dat is redundant and no longer used.
 +
 
 +
4. Several new input files are required. Surface albedo and emissivity climatologies have been generated and must be stored in modis_surf_201210/ within the root data directory (e.g. GEOS_2x2.5/). Climatologies of gases (CH4, N2O, CFC-11, CFC-12, CFC-22 and CCl4) must be stored within the root data directory.  
  
2. A new code folder, GeosRad, is required for the RRTMG code. The module "rrtmg_rad_transfer_mod.F" is the driver code (within GeosCore/) that interfaces with RRTMG.
+
5. A new set of diagnostics (ND71) are available providing the change in radiative flux (DRE) for gases and aerosol, LW/SW, top of atmosphere (TOA) and surface, and clear-sky and all-sky conditions. These also include AOD, SSA and asymmetry parameter for each aerosol species at the requested wavelengths.
  
3. A new set of diagnostics (ND71) are available providing the change in radiative flux (DRE) for gases and aerosol, LW/SW, top of atmosphere (TOA) and surface, and clear-sky and all-sky conditions. These also include AOD, SSA and asymmetry parameter for each aerosol species at the requested wavelengths.
 
  
 
=== Running GCRT ===
 
=== Running GCRT ===
Line 51: Line 89:
  
 
[Under Construction]
 
[Under Construction]
 
=== Authors and collaborators ===
 
* [mailto:heald@mit.edu Colette Heald]  ''(Civil and Environmental Engineering, MIT)''  -- Principal Investigator
 
* [mailto:sbarrett@mit.edu Steven Barrett] ''(Aeronautics and Astronautics, MIT)''
 
* [mailto:ridley@mit.edu David Ridley] ''(Civil and Environmental Engineering, MIT)''
 
* [mailto:kcadyper@aer.com Karen Cady-Pereira] ''(AER)''
 
* [mailto:malvarad@aer.com Matthew Alvarado] ''(AER)''
 
 
 
Questions regarding GCRT can be directed at David (e-mail linked above).
 
 
--[[User:David Ridley|David R.]] 18:00, 08 October 2013 (EST)
 
 
=== GCRT User Groups ===
 
 
{| border=1 cellspacing=0 cellpadding=5
 
|- bgcolor="#cccccc"
 
!User Group
 
!Personnel
 
!Projects
 
|-valign="top"
 
|[http://atmoschem.mit.edu/ Atmospheric Chemistry, Massachusetts Institute of Technology]
 
|[http://www.web.mit.edu/daridley/www/ David Ridley]<br>[http://web.mit.edu/heald/www/ Colette Heald]
 
| [http://web.mit.edu/heald/www/publications.html GCRT Publication] <br> Xuan's work <br> Dust work
 
 
|-valign="top"
 
|Add yours here
 
|
 
|
 
|}
 

Revision as of 14:48, 9 October 2013

Overview

The GEOS-Chem model with online radiative transfer calculations (referred to as GCRT) was developed to allow GEOS-Chem users to produce gas and aerosol direct radiative effect (DRE) output. This alternative to offline coupling allows better temporal resolution in the RT calculations and provides a consist platform for GEOS-Chem users with the widely used radiative transfer package RRTMG.

Most of the added code is 'transparent', therefore this version of the GEOS-Chem model can still be run with the radiation code switched off. The optical properties are calculated at multiple wavelengths so the user is no longer restricted to 550nm as default, so there are associated changes regardless of whether the radiative code is invoked. However, these cause negligible slow down (the default model is actually slightly faster). Compiling with RRTMG=yes requires approximately double the amount of RAM (~15Gb for a 2x2.5 simulation).

This wiki explains the key changes and links to the documentation for getting started running the model and digging deeper into the changes and the auxiliary files required.


Authors and collaborators


Questions regarding GCRT can be directed at David (e-mail linked above).

--David R. 18:00, 08 October 2013 (EST)

GCRT User Groups

User Group Personnel Projects
Atmospheric Chemistry, Massachusetts Institute of Technology David Ridley
Colette Heald
GCRT Publication
Xuan's work
Dust work
Add yours here


Key Changes

1. A new menu for Radiation exists in input.geos (see below). This also includes a wavelength selection for optical depth output that is independent of whether RRTMG is switched on (up to three optical depths can be output in the standard OD-MAP-$ diagnostic, but only the first is used for diagnostics other than the standard bpch output e.g. ND51).

2. A new code folder, GeosRad/, is required for the RRTMG code. The module "rrtmg_rad_transfer_mod.F" is the driver code (within GeosCore/) that interfaces with RRTMG.

3. The optics look-up tables are updated, containing multiple wavelengths and separated into files for each species (soot.dat, so4.dat, org.dat, dust.dat, ssa.dat, ssc.dat) that are stored in the run directory. To prevent discrepancies jv_spec.dat no longer contains optical properties for aerosol, Fast-J uses optics from from the same speciated look-up tables. The new files mean that jv_spec_aod.dat is redundant and no longer used.

4. Several new input files are required. Surface albedo and emissivity climatologies have been generated and must be stored in modis_surf_201210/ within the root data directory (e.g. GEOS_2x2.5/). Climatologies of gases (CH4, N2O, CFC-11, CFC-12, CFC-22 and CCl4) must be stored within the root data directory.

5. A new set of diagnostics (ND71) are available providing the change in radiative flux (DRE) for gases and aerosol, LW/SW, top of atmosphere (TOA) and surface, and clear-sky and all-sky conditions. These also include AOD, SSA and asymmetry parameter for each aerosol species at the requested wavelengths.


Running GCRT

As with the latest version of GEOS-Chem, NetCDF libraries must be installed (see Installing libraries for GEOS-Chem). The code should be compiled using the compile switch RRTMG, i.e. "make RRTMG=yes". A fresh compilation after a "make realclean" will take 15-20 mins (subsequent compiles are much faster).

Once the code is compiled the input.geos file will need configuring:


%%% RADIATION MENU %%%  :

AOD Wavelength (nm)  : 550 440 532

Turn on RRTMG?  : T

Calculate LW fluxes?  : T

Calculate SW fluxes?  : T

Clear-sky flux?  : T

All-sky flux?  : T

Radiation Timestep [min]: 180

Species fluxes  : 0 0 1 0 0 0 0 0 0 1

[O3,ME,SU,NI,AM,BC,OA,SS,DU,PM]


The species for which DRE output is currently available are listed with two-letter identifiers. In the example the DRE is calculated for sulfate (SU) and all particulate matter (PM). The radiation timestep defaults to 180 minutes but can be set for any multiple of the chemistry time step.

In this set up all diagnostics from ND48 to ND51b produce optical depth output at 550nm, but the main diagnostic output contains three copies of the optical depths (and SSA and asymmetry parameters if requested). The output variables have the wavelength appended to the variable name e.g. OPBC550.


[Under Construction]