E3SM v1.0 coupled resolutions and mapping files

List of resolution combinations that E3SM will use, mapping and domain files, how made.

Preferred Tool = tool ACME uses to make mapping files.

  • ESMF = ESMF Regridder,  supports aave, bilinear and patchmap options.
  • Tempest = TempestRemap

TempestRemap has several new algorithms with native support for spectral element meshes.  These algorithms may eventually be implemented in ESMF, so below when we mention TempestRemap, we are referring to the algorithm, not the tool used to compute the maps.    For spectral element source meshes, Tempest conserve (non-monotone) is the most accurate map available and is suitable for upscaling and downscaling.  It is a good replacement for ESMF bilinear and patchmap options.  Tempest conserve+monotone is a potential replacement for ESMF aave maps, but it has two issues that must be resolved before it should be used in an ACME compset:  (1) consistent reference element map between HOMME and TempestRemap, and (2) element-scale artifacts that show up in the land mask defined on the atmosphere grid.  These issues are being worked on under the SciDAC Multiscale project.  

Domain files (from Mariana):  "Domain files  specify the grid and mask for all of the data models and also for CLM.  CLM uses a global surface dataset where it assumes land everywhere - so where there is ocean it assumes wetland. It then uses the domain.lnd.xxx.nc file to determine its land mask (which is really the ocean land mask mapped to the land grid).   By this mechanism you do not need different surface datasets when the land mask is changed (which used to be the case a few years ago).

As a caveat - CICE in prescribed mode (as is the case for F compsets) also uses the domain file to determine its grid and mask."

Production Resolutions

Resolutions used in major campaigns.

Low Resolution: ne30_oEC60to30v3_ICG (Water cycle alpha/beta; BGC experiment)

Atm/Lnd  ne30, 72L
Ocn/Sea-ice:   oEC30to60 (eddy parameterized) ,  60 layers.
ice-sheet:   ais20km (only for now. Greenland maybe next year)
River model: 0.5 degrees
Mapping
Preferred Tool
Name on input data archive (blank = doesn't exist)
Notes
atm 2 ocn fluxes
ESMF aave 

map_ne30np4_to_oEC60to30v3_aave.161222.nc


atm 2 ocn state
Tempest conserve

map_ne30np4_to_oEC60to30v3_conserve_161222.nc

tempest
atm 2 ocn vector
Tempest conserve

map_ne30np4_to_oEC60to30v3_conserve_161222.nc

tempest
ocn 2 atm fluxes
ESMF aave

map_oEC60to30v3_to_ne30np4_aave.161222.nc


ocn 2 atm state
ESMF aave

map_oEC60to30v3_to_ne30np4_aave.161222.nc


lnd 2 ice sheet

map_ne30np4_TO_ais20km_aave.151209.nc
NOT IN config_grids.xml
ice sheet 2 ocean fluxes
ESMF

To be updated to conservative mapping
ice sheet 2 ocean state
ESMF


ice sheet 2 ocean runoff



ocean 2 ice sheet fluxes
ESMF

To be updated to conservative mapping
ocean 2 ice sheet state
ESMF


river 2 ocean

map_r05_to_oEC60to30v3_smoothed.r300e600.161222.nc

runoff_map tool to generate nn
smoothing tool to modify nn map
lnd 2 river

map_ne30np4_to_0.5x0.5rtm_aave_da_110320.nc

river 2 lnd

map_0.5x0.5_nomask_to_ne30np4_nomask_aave_da_c121019.nc


High Res: ne120_oRRS18v3_ICG (Water Cycle and Cryosphere experiment):

Atm/Lnd:  ne120, 72L
Ocn/Sea-ice:   oRRS18to6
Ice Sheet:  ais14to4km (want higher resolution.  Down to 1km.  Need to generate mesh)
River model: 0.125 degrees

2016-3-26: Note: per github issue #770Ruby Leung stated  that the plan is to use a 0.125 (not 0.5) degree River model.  


Mapping
Physical examples
Preferred Tool
Name on input data archive (blank = doesn't exist)
Notes
atm 2 ocn fluxes
precip, shortwave
ESMF aave

map_ne120np4_to_oRRS18to6v3_aave.170111.nc


atm 2 ocn state
temp, pressure
Tempest conserve

map_ne120np4_to_oRRS18to6v3_conserve.170111.nc


atm 2 ocn vector
wind
Tempest conserve
map_ne120np4_to_oRRS18to6v3_conserve.170111.nc

ocn 2 atm fluxes
sensible, latent HF
ESMF aave

map_oRRS18to6v3_to_ne120np4_aave.170111.nc


ocn 2 atm state
SST
ESMF aave
map_oRRS18to6v3_to_ne120np4_aave.170111.nc

lnd 2 ice sheet
SMB

map_ne120np4_to_ais14to4km_aave.160204.nc
ESMF aave
ice sheet 2 ocean fluxes
meltwater, SHFLX


ESMF aave - do we also want nearestdtos?
ice sheet 2 ocean state
ice sheet temp


ESMF aave - do we also want nearestdtos?
ice sheet 2 ocean runoff
icebergs



ocean 2 ice sheet fluxes
accretion, SHFLX


ESMF aave - do we also want nearestdtos?
ocean 2 ice sheet state
ocean temp


ESMF aave - do we also want nearestdtos?
river 2 ocean
river discharge

map_r0125_to_oRRS18to6v3_nn.170111.nc

runoff tool using the method that was successful for
oEC60to30 map
lnd 2 river
runoff

map_ne120np4_to_0.125_nomask_aave.160613.nc


river 2 lnd
flooding

map_0.125_to_ne120np4_nomask_aave.160613.nc


Non-Production Resolutions

Resolution used in testing and other cases.

Ultra Low Resolution: ne11_oQU240 (for coupled integration testing)

Approximately 4 degrees.  Replaces FV 1.9x2.5, T42 with  gx1v6 cases.

ATM/LND:   ne11, 72L option available

Ocn/sea-ice:   240km

ice sheet:    ais20km or stub model SGLC.

River model:  0.5 degrees

(NEED TO UPDATE TABLE)

MappingPreferred ToolName on input data archive (blank = doesn't exist)Notes
 atm 2 ocn fluxes

ESMF aave 

map_ne16np4_to_oQU240_aave.151209.nc


 atm 2 ocn stateTempest conserve

map_ne16np4_to_oQU240_conserve.151209.nc


atm 2 ocn vectorTempest conserve

map_ne16np4_to_oQU240_conserve.151209.nc


ocn 2 atm fluxesESMF aave
map_oQU240_to_ne16np4_aave.151209.nc

ocn 2 atm stateESMF aave
map_oQU240_to_ne16np4_aave.151209.nc

ice sheet 2 ocean fluxes

map_ais20km_to_oQU240_aave.151209.nc

ESMF aave - also have nearest neighbor map
ice sheet 2 ocean state

map_ais20km_to_oQU240_aave.151209.nc

ESMF aave - also have nearest neighbor map
ice sheet 2 ocean runoff


ocean 2 ice sheet fluxes

map_oQU240_to_ais20km_aave.151209.nc

ESMF aave - also have nearest neighbor map
ocean 2 ice sheet state

map_oQU240_to_ais20km_aave.151209.nc

ESMF aave - also have nearest neighbor map
river 2 ocean

map_r05_to_oQU240_nn.160318.nc

runoff_map tool nn, using 'rtm' gridtype
lnd 2 river

map_ne16np4_nomask_to_0.5x0.5_nomask_aave_da_c110922.nc


river 2 lnd

map_0.5x0.5_nomask_to_ne16np4_nomask_aave_da_c110922.nc