-
Notifications
You must be signed in to change notification settings - Fork 9
E3SM Intensive Observation Period Case Library
This page describes the Intensive Observation Period (IOP) Cases that can be run with either:
- The E3SM Single Column Model (SCM)
- The Doubly Periodic configuration of SCREAM (DP-SCREAM) cloud resolving model
This page gives a description of all the cases in our library, which can be run in either of the above configurations. For each case below, a brief orientation to the case is given along with a description of why you may want to use it.
To obtain scripts for either the E3SM SCM or DP-SCREAM configurations please access the wiki for that configuration (links above).
If you use either E3SM SCM or DP-SCREAM in publication or presentation, please cite the appropriate reference:
E3SM SCM: Bogenschutz et al. 2020
DP-SCREAM: Bogenschutz et al. 2023
Verified Cases:
AEROSOLINDIRECT - Study of Aerosol Indirect Effects in China
ARM95 - Deep Cumulus Convection
ARM97 - Deep Cumulus Convection
ARM GCSS Shallow Convection - Diurnal Cycle of Continental Shallow Convection
ARM - SGP Continuous Forcing (2004 - 2015)
DARWIN - Forcing from tropical western pacific
DYCOMS RF01 - Nonprecipitating Marine Stratocumulus
DYCOMS RF02 - Drizzling Subtropical Stratocumulus
DYNAMO AMIE - Dynamics of the Madden Julian Oscillation
DYNAMO North Sounding - Dynamics of the Madden Julian Oscillation
DYNAMO Revelle - Dynamics of the Madden Julian Oscillation
GATE - Tropical Atlantic Deep Convection
GATEIDEAL - Tropical Atlantic Deep Convection
ISDAC - Indirect and semi-direct aerosol campaign
MC3E - Mid-latitude Continental Convective Clouds Experiment
MPACE - Mixed-Phase Arctic Cloud Experiment
MPACE-B Mixed-Phase Stratocumulus Intercomparison
RACORO - Continental Boundary Layer Clouds
RCE - Radiative Convective Equilibrium
TWP-ICE Tropical Pacific Warm Pool Deep Convection
Unverified Cases:
ARM SGP - Southern Great Plains Site
ATEX - Trade Wind Cumuli under a Strong Inversion
LBA - Transition from Shallow to Deep Convection
TOGA-COARE - Tropical Pacific Warm Pool Deep Convection
E3SM Replay Mode
REPLAY - Replay a column from an E3SM run
We have checked that the run script and IOP files for the cases below are free of obvious bugs and design flaws when run in E3SM SCM. Unverified cases do not mean they are necessarily flawed, just that they we have not rigorously tested them.
Overview: These forcings are derived from observations taken as part of the Study of Aerosol Indirect Effects in China (AEROSOLINDIRECT). The ARM mobile facility was deployed to study the Yangtze delta region in southeast China, the center of the satellite rainfall retrieval anomaly and also the area where the aerosol optical depth distribution in China is maximal. This is a 29 day case spanning November 2008.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_AEROSOLINDIRECT.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_AEROSOLINDIRECT.csh
Overview: This case is based on the IOP that took place in the Southern Great Plains (SGP) in July 1995, which covered a total of 30 days. This is a convectively driven case Zhang and Lin (1997) with a period that contained a wide range of summertime weather conditions. The first segment of this case is dominated by local convection and frequent heavy precipitation, while the second segment was generally clear and hot. The last segment of the case was affected by a large, convective complex with sustained precipitation. Data from this IOP formed the basis for the ARM/GCSS Case 1 SCM intercomparison by Ghan et al. (2000). The forcing data was developed using the constrained variational analysis method described in Zhang and Lin (1997) and Zhang et al. (2001).
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_ARM95.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_AEROSOLINDIRECT.csh
Overview: This IOP occurred at the same SGP site as the ARM95 case in June and July of 1997. Similar to the ARM95 case, this case also features several distinct periods characterized by a wide range of summertime weather conditions. Data from this IOP formed the basis for the ARM/GCSS case 3 SCM/CRM intercomparison by Xie et al. (2002) and Xu et al. (2002). The forcing data was developed using the constrained variational analysis method described in Zhang and Lin (1997) and Zhang et al. (2001).
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_ARM97.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_ARM97.csh
Overview: This is a case that simulates the development of shallow cumulus convection over land at the ARM SGP site (Brown et al. 2002) from 21 June 1997. This is a good test case of shallow convection that is an unsteady case and more strong forced, compared to the marine shallow convective cases. The GCSS set-up for this case was run with no microphysics and this SCM run is configured to replicate that idealization.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_ARM_shallow.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_ARM_shallow.csh
Overview: This case provides continuous forcing from the ARM Southern Great Plains (SGP) site from January 2004 through December 2015 (Xie et al. 2004, Tang et al. 2019). It is possible to run this case for the entire 11 year period, but users are encouraged to select a desired subset time period to run on (options provided in the script).
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_SGP_continuous.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_SGP_continuous.csh
Overview: This case is based on the Barbados Oceanographic and Meteorological Experiment (BOMEX) and represents a case of undisturbed trade wind cumulus under steady-state conditions. The forcing for this case follows that of the LES intercomparison study of Siebesma et al. (2003). The GCSS set-up for this case was run with no microphysics and this SCM run is configured to replicate that idealization.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_BOMEX.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_BOMEX.csh
Overview This is a series of forcing files from the ARM Tropical Western Pacific (TWP) Ocean site, located in Darwin, Australia. Note that the forcing for this site is not continuous and broken into 11 segments. The script provided below is configured to run with the first period of forcings taken from the November 03, 2004 for a five day period.
Should the user want to run a different period it is up to the user to enter the correct starting dates and run time in the scripts. This can easily be done by using nco commands with the forcing files. Additional forcing files that are available:
- DARWIN_0405_p1_iopfile_4scam.nc (Start date: November 3, 2004; Duration: 5 days)
- DARWIN_0405_p2_iopfile_4scam.nc (Start date: November 11, 2004; Duration: 45 days)
- DARWIN_0405_p3_iopfile_4scam.nc (Start date: January 6, 2005; Duration: 4 days)
- DARWIN_0405_p4_iopfile_4scam.nc (Start date: January 17, 2005; Duration: 6 days)
- DARWIN_0405_p5_iopfile_4scam.nc (Start date: January 27, 2005; Duration: 29 days)
- DARWIN_0405_p6_iopfile_4scam.nc (Start date: February 28, 2005; Duration: 36 days)
- DARWIN_0506_p1_iopfile_4scam.nc (Start date: November 10, 2004; Duration: 156 days)
- DARWIN_0506_p2_iopfile_4scam.nc (Start date: April 18, 2005; Duration: 12 days)
- DARWIN_0607_p1_iopfile_4scam.nc (Start date: October 12, 2004; Duration: 39 days)
- DARWIN_0607_p2_iopfile_4scam.nc (Start date: November 24, 2004; Duration: 42 days)
- DARWIN_0607_p3_iopfile_4scam.nc (Start date: January 8, 2005; Duration: 8 days)
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_DARWIN.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_DARWIN.csh
Overview: Research flight 1 of the second Dynamics and Chemistry of Marine Stratocumulus field campaign (hereafter DYCOMS RF01) sampled sampled nonprecipitating marine stratocumlus under a strong inversion. the forcing for this case follows that of the LES intercomparison study of Stevens et al. (2005). The GCSS set-up for this case was run with no microphysics and this SCM run is configured to replicate that idealization.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_DYCOMSrf01.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_DYCOMSrf01.csh
Overview: Research flight 2 of the second Dynamics and Chemistry of Marine Stratocumulus field campaign (hereafter DYCOMS RF02) sampled drizzling stratocumulus off the coast of California during the night of 11 July 1999. Data from this flight formed the basis for a SCM intercomparison by Wyant et al. (2007) and an LES intercomparison by Ackerman et al. (2009). This is a classic test case for microphysical processes in stratocumulus, which are a cloud regime that climate models traditionally struggle with and which are critical to the planetary energy budget.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_DYCOMSrf02.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_DYCOMSrf02.csh
Overview This is a 90 day case from the Dynamics of the Madden Julian Oscillation (DYNAMO) field campaign which was an IOP over the Indian Ocean to collect data to study the onset of the MJO. This particular case includes forcing data collected as part of the AMIE-Gan field campaign.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_DYNAMO_amie.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_DYNAMO_amie.csh
Overview This is a 90 day case from the Dynamics of the Madden Julian Oscillation (DYNAMO) field campaign which was an IOP over the Indian Ocean to collect data to study the onset of the MJO. This particular case includes forcing data collected from the north sounding array.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_DYNAMO_northsounding.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_DYNAMO_northsounding.csh
Overview This is a 90 day case from the Dynamics of the Madden Julian Oscillation (DYNAMO) field campaign which was an IOP over the Indian Ocean to collect data to study the onset of the MJO. This particular case includes forcing data collected aboard the R/V Roger Revelle operated by the Scripps Institution of Oceanography.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_DYNAMO_revelle.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_DYNAMO_revelle.csh
Overview: This case is based on the Global Atmospheric Research Program's Atlantic Tropical Experiment (GATE, Houze and Betts 1981), who's goal was to improve basic understanding of topical convection and its role in the global atmospheric circulation. This is a 20 day case that begins on 30 August 1974.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_GATEIII.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_GATEIII.csh
This case represents an idealized version of the 20 day traditional GATE case. This is a 24 hours simulation that uses steady state time averaged large scale forcing from the GATEIII observed period. Radiation tendencies are prescribed in this case. Due to the relatively short duration of this case it is ideal for performing high resolution cloud resolving model studies. This case has been used, and is documented in, Khairoutdinov et al. (2009), Xu et al. (1992), and Fu et al. (1995).
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_scream_GATEIDEAL.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_GATEIDEAL.csh
Overview This is a 23 month case from the Observations and Modeling of the Green Ocean Amazon (GOAMAZON) field campaign (Martin et al. 2017 ,Tang et al. 2016). Observations and forcing are derived from the ARM Mobile Facility, which was located downwind of the city of Manaus, Brazil near Manacapuru from January 2014 to November 2015. The site was situated so that it experienced the extremes of (i) a pristine atmosphere when the Manaus pollution plume meandered and (ii) heavy pollution and the interactions of that pollution with the natural environment when the plume regularly intersected the site.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_GOAMAZON.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_GOAMAZON.csh
Overview: The Indirect and semi-direct aerosol campaign is an intensive cloud and aerosol IOP conducted at ARM's North Slope of Alaska (NSA) locale for three weeks in April 2008. This is a 29 day case.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_ISDAC.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_ISDAC.csh
Overview: The Midlatitude Continental Convective Clouds Experiment took place from April 22 - June 6, 2011, near Lamont, Oklahoma in the region surrounding the Department of Energy (DOE) Atmospheric Radiation Measurement (ARM) Program Southern Great Plains Central Facility (Xie et al. 2014). A broad variety of cloud and precipitation types were sampled during the MC3E including cumulus clouds, severe thunderstorms, mesoscale convective systems and widespread regions of stratiform precipitation.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_MC3E.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_MC3E.csh
Overview: The Mixed-Phase Arctic Cloud Experiment (MPACE, Verlinde et al. 2007, Xie et al. 2006) sampled clouds over open ocean near Barrow, AK with the goal to collect observations to advance the understanding of the dynamics and microphysical processes in mixed-phase clouds. This case contains forcing for the entire IOP period.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_MPACE.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_MPACE.csh
Overview: The Mixed-Phase Arctic Cloud Experiment (MPACE, Verlinde et al. 2007) sampled clouds over open ocean near Barrow, AK with the goal to collect observations to advance the understanding of the dynamics and microphysical processes in mixed-phase clouds. Here we use the same forcing of that described in the intercomparison of Klein et al. (2009), which represents a cold-air outbreak mixed-phase stratocumulus cloud.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_MPACEB.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_MPACEB.csh
Overview: The routine ARM Aerial Facility (AAF) Clouds with Low Liquid Water Depths (CLOWD) Optical Radiative Observations (RACORO, Vogelmann et al. (2012)) field campaign was conducted in Oklahoma between January and July of 2009 with the goal of conducting long-term routine flights in the boundary layer liquid water clouds over the DOE ARM SGP site. This IOP focuses on a 28 day period in May of 2009, which predominately consisted of cumulus convection in the observations. The forcing was created from the NOAA Rapid Update Cycle (RUC) analyses that were constrained by the ARM surface observations through a variational analysis approach described in Xie et al. (2004) .
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_RACORO.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_RACORO.csh
Radiative convective equilibrium (RCE) describes a balance between the cooling of the atmosphere by radiation and the heating through latent heat release and surface fluxes. RCE has long been used as a simple framework for investigating the behavior of moist convection and studying convective organization (Held et al. 1993).
- E3SM SCM run script name: Case exclusive to DP-SCREAM
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_RCE.csh
Overview: Rain in Cumulus over the Ocean (RICO) was a field campaign that took place during November 2004 through January 2005 in the trades over western Africa (Rauber et al. 2007 ). The main goal of the campaign was to measure processes related to the formation of rain in shallow cumulus and how precipitation modifies the structure and ensembles of trade wind clouds. This case uses the same forcing and setup as that used in the RICO LES intercomparison study of VanZanten et al. (2011) . RICO is a good test of maritime shallow convection, but since its forcing is a composite over many days, it is difficult to compare directly against observations.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_RICO.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_RICO.csh
Overview: This case is based on the Tropical Pacific Warm Pool International Cloud Experiment (TWP-ICE), which was an intense airborne measurement campaign conducted in the region near Darwin, Northern Australia in early 2006 with the goal to describe the properties of tropical cirrus and the convection that leads to their formation. The IOP forcing file for this case begins on 17 January 2006 and is a 27 day case, and described in Xie et al. (2010).
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_TWP06.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_TWP06.csh
We have not checked whether the cases below actually run successfully or provide credible output. We are archiving them here in case others need them before we have time to perform any testing.
Overview: This is a series of forcing files from the ARM Southern Great Plains (SGP) site. This is similar to the ARM Continuous Forcing case, but this contains several periods of forcing that falls outside of that window. The script provided for this case is set up to run the period that starts on March, 2000 (forcing file SGP0003_iopfile_4scam.nc).
Note that there are 11 other forcing files available but it is up to the user to enter the correct starting dates and run time in the scripts. This can easily be done by using nco commands with the forcing files. Additional forcing files that are available:
- SGP9704_iopfile_4scam.nc (Start date: April 2, 1997; Duration: 21 days)
- SGP9706_iopfile_4scam.nc (Start date: June 18, 1997; Duration: 29 days)
- SGP9709_iopfile_4scam.nc (Start date: September 15, 1997; Duration: 21 days)
- SGP9804_iopfile_4scam.nc (Start date: April 27, 1998; Duration: 21 days)
- SGP9901_iopfile_4scam.nc (Start date: January 19, 1999; Duration: 21 days)
- SGP9903_iopfile_4scam.nc (Start date: March 1, 1999; Duration: 21 days)
- SGP0003_iopfile_4scam.nc (Start date: March 1, 2000; Duration: 21 days)
- SGP0009_iopfile_4scam.nc (Start date: September 25, 2000; Duration: 13 days)
- SGP0011_iopfile_4scam.nc (Start date: November 27, 2000; Duration: 2 days)
- SGP0205_iopfile_4scam.nc (Start date: May 25, 2002; Duration: 21 days)
- SGP0211_iopfile_4scam.nc (Start date: November 6, 2002; Duration: 20 days)
- SGP0305_iopfile_4scam.nc (Start date: May 1, 2003; Duration: 30 days)
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_SGP.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_SGP.csh
Overview: This case is based on the Atlantic Trade Wind Experiment (ATEX) that took place in February 1969 in the Atlantic northeast trade wind region. The forcing for this case follows that of the LES intercomparison study of Stevens et al. (2001) and represents a case of cumulus under broken stratocumulus.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_ATEX.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_ATEX.csh
This six hour case represents an idealized simulaiton of the shallow-to-deep cumulus convection transition. The simulated case is based on idealization of observations made during the Large-Scale Biosphere-Atmosphere (LBA) experiment in Amazonia, Brazil during the boreal winter of 1999. This cases follows the setup from that documented in Khairoutdinov et al. (2006).
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_scream_LBA.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_LBA.csh
Overview: This case is based on the Small Particles in Cirrus Clouds (SPARTICUS) field campaign, which took place at the ARM Climate Research Facility from December 2009 through June 2010. The IOP forcing for this case begins on April 1, 2010 and is 30 days in duration. The forcing was created from the NOAA Rapid Update Cycle (RUC) analyses that were constrained by the ARM surface observations through a variational analysis approach described in Xie et al. (2004).
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_SPARTICUS.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_SPARTICUS.csh
Overview: This case is based on the tropical ocean - global atmosphere (TOGA) coupled ocean atmosphere response experiment (COARE), which was an IOP that took place from 1 November 1992 through 28 February 1993 in the western pacific warm pool to better understand the principle process responsible for coupling of the ocean and atmosphere. The IOP forcing file for this case begins on 18 December 1992 and is a 22 day case.
- E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_TOGAII.csh
- DP-SCREAM run script name: DP_SCREAM_scripts/run_dp_scream_TOGAII.csh
Overview This functionality provides the ability to Replay a column from a full E3SM simulation. NOTE that currently the E3SM SCM REPLAY option CANNOT provide bit-4-bit reproducibility with an E3SM run. It can, however, reproduce the behavior of an E3SM column, which is appropriate for most scientific applications.
07/10/2024 UPDATE The Replay method has been restored in E3SM master (As of April 25, 2024) after quasi-popular demand. The new documentation is provided below.
REPLAY mode is only compatible with E3SM SCM and NOT DP-SCREAM
Below are the instructions for running on E3SM master. Please be sure you are using master AFTER April 25, 2024 commit. Note that these changes did not make it in time for the maint-3.0.0 tag. If you are interested in running replay with the v1 code please see the Legacy Instructions for Running Replay (in E3SMv1) and you must use the maint-1.2 branch. It is not possible to run the v2 code with replay.
Running the E3SM REPLAY option is a multiple phase process:
- You need to generate the forcing from an E3SM simulation. To do this, configure your E3SM simulation with the directive "-e3smreplay". By default, this will generate forcing data at EVERY E3SM time step and for the entire globe and place that data in the h1 history tape. This can add up to lots of data very quickly. Therefore, if there is a particular region of the globe you are interested in, it is strongly advised that you produce forcing for a subset of the globe with the "fincl2lonlat" namelist option. You can find documentation on this namelist variable in the components/cam/bld/namelist_files/namelist_definition.xml file.
Tip: make sure add "append" when configuring with e3smreplay (i.e. ./xmlchange --id CAM_CONFIG_OPTS --append --val=’-e3smreplay’), else you may overwrite all E3SM default physics packages.
NOTE: It is advisable to NOT add any additional data to fincl2 in your namelist and make sure you are writing at the frequency you want write at. Set nhtfrq(2) = 1 to output every E3SM timestep (though you don't have to). Also, it is advised to set mfilt(2) to a large number to ensure all your forcing is in one file (else, they will have to be stitched together manually post-run).
-
Post-process your output into an IOP file. For convenience I have added a script in the repo. Please modify the header information. You will select the lat and lon that you want to replay and this will generate an IOP file for the column closest to that location.
-
Run the E3SM SCM with your forcing file (this will be the h1 file produced in step 1... or the file produced in step 2 if you had to rename the forcing fields). You should be using the same E3SM code tag in which you generated the forcing file from. Please use the E3SM SCM Replay script below and fill out all the required information in the USER DEFINED settings. After you build the model, you should verify that your namelist settings from your global run and SCM run are as close as possible (compare the atm_in files from the two runs). If there are significant differences, then change your namelist in your SCM REPLAY script and compile and run again.
E3SM SCM run script name: E3SM_SCM_scripts/run_e3sm_scm_REPLAY.csh
TIPS: If this is your first time running the REPLAY option it is STRONGLY advised that you test out a short simulation first. For example, run E3SM for a day or two with your output and make sure this runs in the SCM.