Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Prosed Plan:

...

Note

EAMxx is not yet officially supported. Use these pages at your own risk.

Background:

E3SM has developed the idiosyncratic but convenient habit of referring to specific humidity (=mass of water species divided by mass of total air) as wet mixing ratio and the actual mixing ratio (=mass of water species divided by mass of dry air) as dry mixing ratio.

Unlike EAMf90, the EAMxx atmospheric driver(AD) are “wet” requires all variables passed to it to be wet mixing ratios. For each parameterization Each process called by AD , it is the responsibility of the parameterization to convert wet mixing ratios to dry mixing ratios (if needed) for its use. The tendencies computed by the parameterization should also be converted back to wet mixing ratios before they are passed on to AD. For parameterizations can choose to use wet or dry mixing ratio, but must convert its variables (and - if required - the time tendencies it produces) back to wet mixing ratio. For processes which exclusively use wet mixing ratiosratio, there is no need for any conversion however, for parameterizations which use dry mixing ratios, following steps must be followed:

  1. Interface layer of parameterization should convert wet mixing ratio to dry mixing ratios

  2. Parameterization computes tendencies using the dry mixing ratios internally

  3. Interface layer of the parameterization will then convert the dry mixing ratio tendencies to wet mixing ratios

  4. These wet mixing ratio tendencies are then passed on to AD

SCREAM provides . SCREAM provide following methods for converting dry mass mixing ratios ratio (mmr) to wet mixing ratios mmr and vice versa via functions:

calculate_drymmr_from_wetmmr

calculate_wetmmr_from_drymmr

Type of mixing ratios used by SCREAM parameterization:

  1. P3 - Dry mixing ratios

  2. SCREAM - Dry mixing ratios

  3. HOMME - Wet mixing ratios

  4. RRTMGP - ?

Tasks:

P3 (uses dry mixing ratios):

  •  Ensure that P3 converts wet mixing ratios to dry mixing ratios for all constituents in its interface layer
  •  Ensure that tendencies from P3 are converted back to wet mixing ratios

SHOC (uses dry mixing ratios):

  •  Ensure that SHOC converts wet mixing ratios to dry mixing ratios for all constituents in its interface layer
  •  Ensure that tendencies from SHOC are converted back to wet mixing ratios

RRTMGP (uses ? mixing ratios):

...

The same rules hold for volume mixing ratio (vmr). For processes requiring vmr, SCREAM provide the following functions:

calculate_mmr_from_vmr

calculate_vmr_from_mmr

vmr can be dry or wet. Appropriate conversion should be made based on parameterization requirements. Tendencies computed by the parameterization should be converted back to wet mmr before passing these back to AD.

Explanation for why each process is wet or dry:

Dycore:wet mmr - The dycore interface is currently written for wet mixing ratios because internally, the dycore’s prognostic mass variable is total mass (not dry mass). Working with wet mixing ratios allows the dycore to simply compute tracer mass, without ever computing “dry mass”. Dry mass is an unusual quantity which would not normally be used within the dycore.

Atmosphere Driver:wet mmr - Because many variables passed to the AD are advected by the dycore, we decided to insist that all variables handled by the AD are wet.

P3:dry mmr - Microphysics contains a lot of empirical parameterizations. Empirical parameterizations tend to assume variables are couched in dry mixing ratio since that’s what’s usually measured observationally.

SHOC:wet mmr - I should re-read the SHOC overview paper before explaining this, but basically SHOC is derived from the Navier-Stokes equations which should be able to be adapted equally well for wet or dry variables.

RRTMGP:wet vmr - Ben Hillman ?