5. Configurations

The UFS Weather Model (WM) can be run in any of several configurations, from a single-component atmospheric model to a fully coupled model with multiple earth system components (e.g., atmosphere, ocean, sea-ice, land, and mediator). This chapter documents a few of the currently supported configurations. For a full list of supported configurations, view the rt.conf and rt.gnu.conf files.

Attention

This chapter is a work in progress. There are a multitude of options for configuring the UFS WM, and this chapter merely details a few supported configurations. It will be expanded over time to include the full set of configurations supported for WM regression tests (RTs).

Table 5.1 Documented UFS Weather Model Configuration Categories

Configuration Category

Description

ATM

Standalone Atmospheric Model (ATM)

ATML

Coupled ATM and LND

LND

Coupled CDEPS - DATM - LND -CMEPS

RRFS

ATM with data assimilation

This chapter details the supported build/run options for each supported configuration. Click on the configuration category in Table 5.1 to go to that section. Each configuration category includes sample code for setting CMAKE_FLAGS and CCPP_SUITES. Additionally, there is a list of preferred physics suites, examples of nems.configure files, and links to information on other input files required to run the model.

5.1. Background

Each RT configuration file (located in the ufs-weather-model/tests/tests directory) sets default variables by calling setup functions from ufs-weather-model/tests/default_vars.sh (see defaults here). Then, the RT configuration file sets test-specific variablesthese values will override the defaults. For example, the control_c48 test file sets a list of files that it will use, calls the export_fv3 function from default_vars.sh, and then exports test-specific variables. An excerpt is included below (... indicates omitted lines):

export LIST_FILES="sfcf000.nc \
                sfcf024.nc \
                atmf000.nc \
                atmf024.nc \
                RESTART/20210323.060000.coupler.res \
                RESTART/20210323.060000.fv_core.res.nc \
                ...
                RESTART/20210323.060000.sfc_data.tile5.nc \
                RESTART/20210323.060000.sfc_data.tile6.nc"

export_fv3

export INPES=1
export JNPES=1
export WRTTASK_PER_GROUP=2
export NPZ=127
export NPZP=128
export NPX=49
export NPY=49
export DT_ATMOS=1200
...

default_vars.sh contains eight functions that set defaults for different types of tests. Table 5.2 describes what each function does.

Table 5.2 default_vars.sh functions

Function Name

Description

export_fv3

Set variables to the FV3 default values (first common variables, then model-specific ones). Different machines may have different defaults for some variables.

export_cpl

Set variables to the default values for coupled / S2S configurations.

export_35d_run

Set variables to the default values for EMC’s weekly coupled benchmark 35d tests (see rt_35d.conf).

export_datm_cdeps

Set variables to the default values for configurations that use the data atmosphere (DATM) component.

export_hafs_datm_cdeps

Set variables to the default values for HAFS configurations that use the data atmosphere (DATM) component.

export_hafs_docn_cdeps

Set variables to the default values for HAFS configurations that use the data ocean (DOCN) component.

export_hafs_regional

Set variables to the default values for regional HAFS configurations.

export_hafs

Set variables to the default values for HAFS configurations.

Multiple default_vars.sh functions may be called in a given test. Values set in one function will be overridden when the same values are set in a subsequent function.

The most up-to-date list of develop branch data required for each test is available in the UFS WM RT Data Bucket. Users should click on “Browse Bucket” and navigate to the most recent date (in develop-YYYY-MM-DD format). Then, users should select Intel or GNU based on the compiler used in the test they want to run and then select the test name to see the required data.

5.2. Atmospheric Model Configurations

The atmospheric model configurations all use the UFS WM atmospheric component and may couple it with other models (e.g., a wave or aerosol model).

5.2.1. ATM - Standalone Atmospheric Model

The standalone atmospheric model (ATM) is an FV3-based prognostic atmospheric model that can be used for short- and medium-range research and operational forecasts. In standalone mode, ATM is not coupled to any other model.

Current ATM regression tests cover a wide variety of functionality and involve several physics tests. Table 5.3 contains a small selection of ATM-only RTs; it will be expanded to cover the full range of ATM-only supported configurations in time:

Table 5.3 ATM regression test descriptions

Test Name

Description

Physics Suite (see namelist options here)

DT_ATMOS

Start Date

Forecast Length (hours)

control_c48

Compare global control C48L127 results with previous trunk version

FV3_GFS_v16

1200

2021-03-22 06:00:00

24

control_p8

Compare global control results with previous trunk version

FV3_GFS_v17_p8

720

2021-03-22 06:00:00

24

regional_control

FV3 regional control (hi-res 3km, small domain) test

FV3_GFS_v15_thompson_mynn_lam3km

1800

2016-10-03 00:00:00

6

Sample CMAKE_FLAGS Setting

export CMAKE_FLAGS="-DAPP=ATM -DCCPP_SUITES=FV3_GFS_v16,FV3_GFS_v17_p8,FV3_GFS_v15_thompson_mynn_lam3km -D32BIT=ON"

Supported Physics Suites

Table 5.4 Physics suites used in the ATM configurations above

Physics Suite

Description

FV3_GFS_v16

The CCPP GFS_v16 physics suite is described in the CCPP documentation here.

FV3_GFS_v17_p8

The CCPP GFS_v17_p8 physics suite is described in the CCPP documentation here.

FV3_GFS_v15_thompson_mynn_lam3km

The CCPP GFS_v15 physics suite with the Thompson Aerosol-Aware Cloud Microphysics Scheme (see here) and Mynn Surface Layer Module (see here) tailored for a limited area model (LAM) 3-km resolution grid.

Additional Information

Input files required for ATM configurations can be viewed in Section 4.1.1 or in the UFS WM RT Data Bucket. Information on nems.configure files is available in Section 4.2.4, and a sample ATM nems.configure file (nems.configure.atm.IN) is available here.

5.2.2. ATMW

COMING SOON!

5.2.3. ATMAERO

COMING SOON!

5.2.4. ATMAQ

COMING SOON!

5.2.5. ATML

The ATML configuration couples ATM with LND. These tests use default values set in the export_fv3 function of default_vars.sh.

Attention

There is an issue with -D32BIT=ON in the ATM-LND tests, and NoahMP requires r8 libraries.

Table 5.5 ATML regression test descriptions

Test Name

Description

Physics Suite (see namelist options here)

DT_ATMOS

Start Date

Forecast Length (hours)

control_p8_atmlnd_sbs

Compare global control results with previous trunk version

FV3_GFS_v17_p8

720

2021-03-22 06:00:00

24

Sample CMAKE_FLAGS Setting

export CMAKE_FLAGS="-DAPP=ATML -DCCPP_SUITES=FV3_GFS_v17_p8"

Supported Physics Suites

Table 5.6 Physics suites used in the ATM configurations above

Physics Suite

Description

FV3_GFS_v17_p8

The CCPP GFS_v17_p8 physics suite is described in the CCPP documentation here.

Additional Information

Input files required for ATML configurations can be viewed in Section 4.1.1 (ATM) and Section 4.1.9 (LND) or in the UFS WM RT Data Bucket. Information on nems.configure files is available in Section 4.2.4, and a sample ATML nems.configure file (nems.configure.atm_lnd.IN) is available here.

5.3. Rapid Refresh Forecast System (RRFS)

The RRFS configurations use an ATM-only configuration on a high-resolution regional grid with data assimilation capabilities. These tests use the default values set in the export_fv3 function of default_vars.sh unless other values are explicitly set.

Current RRFS regression tests cover a wide variety of functionality and involve several physics tests. Table 5.7 contains RTs for RRFS functionality.

Attention

Certain physics-related settings are common to all of the supported RRFS configurations. These values are set in each test’s configuration file because they differ from the default_vars.sh values:

  • Set to FALSE: DO_SAT_ADJ, HYBEDMF, DO_DEEP, SHAL_CNV, LHEATSTRG

  • Set to TRUE: DO_MYNNEDMF, DO_MYNNSFCLAY

  • Set to VALUE: DNATS=0, IALB=2, IEMS=2, IMFSHALCNV=-1, IMFDEEPCNV=-1

The “Detailed Physics Parameters” column in Table 5.7 details physics settings that differ from both the default_vars.sh values and these RRFS-specific defaults.

Table 5.7 RRFS regression test descriptions

Test Name            

Description

General Physics Parameters

Detailed Physics Parameters (see namelist options here for variable definitions)

Start Date    

Fcst Length (hours)

Output Grid

Configuration Files

Other

rrfs_v1beta

Compare RRFS_v1beta results with previous trunk version

Suite: CCPP_SUITE=FV3_RRFS_v1beta

Microphysics: IMP_PHYSICS=8

Time Step: DT_ATMOS=300

Set to FALSE: Default RRFS values only

Set to TRUE: LRADAR, LTAEROSOL

Set to VALUE: NSTF_NAME=’2,0,0,0,0’, IAER=5111, LSM=2, LSOIL_LSM=4

2021-03-22 06:00:00

24

OUTPUT_GRID=gaussian_grid

Grid Parameters: NPZ=127, NPZP=128

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure.IN FV3_RUN=control_run.IN INPUT_NML=rap.nml.IN FIELD_TABLE=field_table_thompson_aero_tke DIAG_TABLE=diag_table_rap_noah

RESTART_INTERVAL=”6 -1”, OUTPUT_FH=’0 09 12’

rrfs_v1beta_debug

Compare rrfs_v1beta_debug results with previous trunk version

Suite: CCPP_SUITE=FV3_RRFS_v1beta

Microphysics: IMP_PHYSICS=8

Time Step: DT_ATMOS=300

Set to FALSE: Default RRFS values only

Set to TRUE: LRADAR, LTAEROSOL

Set to VALUE: NSTF_NAME=’2,0,0,0,0’, IAER=5111, LSM=2, LSOIL_LSM=4

2021-03-22 06:00:00

1

OUTPUT_GRID=gaussian_grid

Grid Parameters: NPZ=127, NPZP=128

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure.IN FV3_RUN=control_run.IN INPUT_NML=rap.nml.IN FIELD_TABLE=field_table_thompson_aero_tke DIAG_TABLE=diag_table_rap_noah

OUTPUT_FH=”0 1”

rrfs_v1nssl

Compare RRFS_v1nssl results with previous trunk version

Suite: CCPP_SUITE=FV3_RRFS_v1nssl

Microphysics: IMP_PHYSICS=17

Time Step: DT_ATMOS=300

Set to FALSE: LTAEROSOL

Set to TRUE: NSSL_CCN_ON, NSSL_HAIL_ON, NSSL_INVERTCCN

Set to VALUE: NSTF_NAME=’2,0,0,0,0’, IAER=5111, CS=17, NWAT=7, LSM=2, LSOIL_LSM=4

2021-03-22 06:00:00

24

OUTPUT_GRID=gaussian_grid

Grid Parameters: NPZ=127, NPZP=128

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure.IN FV3_RUN=control_run.IN INPUT_NML=rap.nml.IN FIELD_TABLE=field_table_nssl_tke DIAG_TABLE=diag_table_rap_noah

RESTART_INTERVAL=”6 -1”, OUTPUT_FH=’0 09 12’

rrfs_v1nssl_nohailnoccn

Compare RRFS_v1nssl_nohailnoccn results with previous trunk version

Suite: CCPP_SUITE=FV3_RRFS_v1nssl

Microphysics: IMP_PHYSICS=17

Time Step: DT_ATMOS=300

Set to FALSE: NSSL_CCN_ON, NSSL_HAIL_ON, LTAEROSOL

Set to TRUE: NSSL_INVERTCCN

Set to VALUE: NSTF_NAME=’2,0,0,0,0’, IAER=5111, NWAT=6, LSM=2, LSOIL_LSM=4

2021-03-22 06:00:00

24

OUTPUT_GRID=gaussian_grid

Grid Parameters: NPZ=127, NPZP=128

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure.IN FV3_RUN=control_run.IN INPUT_NML=rap.nml.IN FIELD_TABLE=field_table_nssl_nohailnoccn_tke DIAG_TABLE=diag_table_rap_noah

RESTART_INTERVAL=”6 -1”, OUTPUT_FH=’0 09 12’

rrfs_conus13km_hrrr_warm

HRRR physics on 13km domain, control run

Suite: CCPP_SUITE=FV3_HRRR

Microphysics: IMP_PHYSICS=8

Time Step: DT_ATMOS=120

Set to FALSE: SEDI_SEMI, MAKE_NH, EXTERNAL_IC, NGGPS_IC, LDIAG3D, QDIAG3D, RANDOM_CLDS, CNVCLD, DO_SPPT, DO_SHUM, DO_SKEB, DO_UGWP_*

Set to TRUE: SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE

Set to VALUE: DECFL=8, LKM=1, IOPT_LAKE=2, ICLIQ_SW=2, IOVR=3, KICE=9, LSM=3, LSOIL_LSM=9, NA_INIT=0, FHZERO=1.0, FHCYC=0.0, IAER=1011, CDMBWD=’3.5,1.0’, LNDP_TYPE=0, N_VAR_LNDP=0, GWD_OPT=3

2021-05-12 16:00:00

2

OUTPUT_GRID=lambert_conformal

Grid Parameters: INPES=12, JNPES=12, NPX=397, NPY=233, NPZ=65, NPZP=66

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure_rrfs_conus13km.IN FV3_RUN=rrfs_warm_run.IN INPUT_NML=rrfs_conus13km_hrrr.nml.IN FIELD_TABLE=field_table_thompson_aero_tke DIAG_TABLE=diag_table_hrrr

RESTART_INTERVAL=1, WARM_START=.true., READ_INCREMENT=.false., RES_LATLON_DYNAMICS=“‘fv3_increment.nc’”

rrfs_conus13km_hrrr_warm_debug

HRRR physics on 13km domain, debug run

Suite: CCPP_SUITE=FV3_HRRR

Microphysics: IMP_PHYSICS=8

Time Step: DT_ATMOS=120

Set to FALSE: SEDI_SEMI, MAKE_NH, EXTERNAL_IC, NGGPS_IC, READ_INCREMENT, LDIAG3D, QDIAG3D, RANDOM_CLDS, CNVCLD, DO_SPPT, DO_SHUM, DO_SKEB, DO_UGWP_*

Set to TRUE: SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE

Set to VALUE: DECFL=8, LKM=1, IOPT_LAKE=2, ICLIQ_SW=2, IOVR=3, KICE=9, LSM=3, LSOIL_LSM=9, NA_INIT=0, FHZERO=1.0, FHCYC=0.0, IAER=1011, CDMBWD=’3.5,1.0’, LNDP_TYPE=0, N_VAR_LNDP=0, GWD_OPT=3

2021-05-12 16:00:00

1

OUTPUT_GRID=lambert_conformal

Grid Parameters: INPES=12, JNPES=12, NPX=397, NPY=233, NPZ=65, NPZP=66

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure_rrfs_conus13km.IN FV3_RUN=rrfs_warm_run.IN INPUT_NML=rrfs_conus13km_hrrr.nml.IN FIELD_TABLE=field_table_thompson_aero_tke DIAG_TABLE=diag_table_hrrr

RESTART_INTERVAL=1, WARM_START=.true., READ_INCREMENT=.false., RES_LATLON_DYNAMICS=“‘fv3_increment.nc’”

rrfs_conus13km_hrrr_warm_restart_mismatch

HRRR physics on 13km domain, control run

Suite: CCPP_SUITE=FV3_HRRR

Microphysics: IMP_PHYSICS=8

Time Step: DT_ATMOS=120

Set to FALSE: SEDI_SEMI, MAKE_NH, EXTERNAL_IC, NGGPS_IC, LDIAG3D, QDIAG3D, RANDOM_CLDS, CNVCLD, DO_SPPT, DO_SHUM, DO_SKEB, DO_UGWP_*

Set to TRUE: SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE

Set to VALUE: DECFL=8, LKM=1, ICLIQ_SW=2, IOVR=3, KICE=9, LSM=3, LSOIL_LSM=9, NA_INIT=0, FHZERO=1.0, FHCYC=0.0, IAER=5111, CDMBWD=’3.5,1.0’, LNDP_TYPE=0, N_VAR_LNDP=0, GWD_OPT=3

2021-05-12 16:00:00

2

OUTPUT_GRID=lambert_conformal

Grid Parameters: INPES=12, JNPES=12, NPX=397, NPY=233, NPZ=65, NPZP=66

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure_rrfs_conus13km.IN FV3_RUN=rrfs_warm_run.IN INPUT_NML=rrfs_conus13km_hrrr.nml.IN FIELD_TABLE=field_table_thompson_aero_tke DIAG_TABLE=diag_table_hrrr

FHROT=1, RESTART_FILE_PREFIX=$( printf %04d%02d%02d.%02d0000 $SYEAR $SMONTH $SDAY $(( SHOUR+FHROT )) ), RRFS_RESTART=YES, WARM_START=.true., READ_INCREMENT=.false., RES_LATLON_DYNAMICS=“‘fv3_increment.nc’”,

rrfs_smoke_conus13km_hrrr_warm

HRRR smoke physics on 13km domain, control run

Suite: CCPP_SUITE=FV3_HRRR

Microphysics: IMP_PHYSICS=8

Time Step: DT_ATMOS=120

Set to FALSE: SEDI_SEMI, MAKE_NH, EXTERNAL_IC, NGGPS_IC, LDIAG3D, QDIAG3D, RANDOM_CLDS, CNVCLD, DO_SPPT, DO_SHUM, DO_SKEB, DO_UGWP_*

Set to TRUE: RRFS_SMOKE, SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE

Set to VALUE: DECFL=8, SEAS_OPT=0, LKM=1, IOPT_LAKE=2, ICLIQ_SW=2, IOVR=3, KICE=9, LSM=3, LSOIL_LSM=9, NA_INIT=0, FHZERO=1.0, FHCYC=0.0, IAER=1011, CDMBWD=’3.5,1.0’, LNDP_TYPE=0, N_VAR_LNDP=0, GWD_OPT=3

2021-05-12 16:00:00

2

OUTPUT_GRID=lambert_conformal

Grid Parameters: INPES=12, JNPES=12, NPX=397, NPY=233, NPZ=65, NPZP=66,

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure_rrfs_conus13km.IN FV3_RUN=rrfs_warm_run.IN INPUT_NML=rrfs_conus13km_hrrr.nml.IN FIELD_TABLE=field_table_thompson_aero_tke_smoke DIAG_TABLE=diag_table_hrrr DIAG_TABLE_ADDITIONAL=diag_additional_rrfs_smoke

RESTART_INTERVAL=1, WARM_START=.true., READ_INCREMENT=.false., RES_LATLON_DYNAMICS=“‘fv3_increment.nc’”

rrfs_smoke_conus13km_hrrr_warm_2threads

HRRR smoke physics on 13km domain, different threads

Suite: CCPP_SUITE=FV3_HRRR

Microphysics: IMP_PHYSICS=8

Time Step: DT_ATMOS=120

Set to FALSE: SEDI_SEMI, MAKE_NH, EXTERNAL_IC, NGGPS_IC, LDIAG3D, QDIAG3D, RANDOM_CLDS, CNVCLD, DO_SPPT, DO_SHUM, DO_SKEB, DO_UGWP_*

Set to TRUE: RRFS_SMOKE, SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE

Set to VALUE: DECFL=8, SEAS_OPT=0, LKM=1, ICLIQ_SW=2, IOVR=3, KICE=9, LSM=3, LSOIL_LSM=9, NA_INIT=0, FHZERO=1.0, FHCYC=0.0, IAER=1011, CDMBWD=’3.5,1.0’, LNDP_TYPE=0, N_VAR_LNDP=0, GWD_OPT=3

2021-05-12 16:00:00

2

OUTPUT_GRID=lambert_conformal

Grid Parameters: INPES=$INPES_thrd, JNPES=$JNPES_thrd, INPES=12, JNPES=12, NPX=397, NPY=233, NPZ=65, NPZP=66

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure_rrfs_conus13km.IN FV3_RUN=rrfs_warm_run.IN INPUT_NML=rrfs_conus13km_hrrr.nml.IN FIELD_TABLE=field_table_thompson_aero_tke_smoke DIAG_TABLE=diag_table_hrrr DIAG_TABLE_ADDITIONAL=diag_additional_rrfs_smoke

RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.true, READ_INCREMENT=.false., RES_LATLON_DYNAMICS=“‘fv3_increment.nc’”

rrfs_smoke_conus13km_hrrr_warm_debug

HRRR smoke physics on 13km domain, control run

Suite: CCPP_SUITE=FV3_HRRR

Microphysics: IMP_PHYSICS=8

Time Step: DT_ATMOS=120

Set to FALSE: SEDI_SEMI, MAKE_NH, EXTERNAL_IC, NGGPS_IC, LDIAG3D, QDIAG3D, RANDOM_CLDS, CNVCLD, DO_SPPT, DO_SHUM, DO_SKEB, DO_UGWP_*

Set to TRUE: RRFS_SMOKE, SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE

Set to VALUE: DECFL=8, SEAS_OPT=0, LKM=1, ICLIQ_SW=2, IOVR=3, KICE=9, LSM=3, LSOIL_LSM=9, NA_INIT=0, FHZERO=1.0, FHCYC=0.0, IAER=1011, CDMBWD=’3.5,1.0’, LNDP_TYPE=0, N_VAR_LNDP=0, GWD_OPT=3

2021-05-12 16:00:00

1

OUTPUT_GRID=lambert_conformal

Grid Parameters: INPES=12, JNPES=12, NPX=397, NPY=233, NPZ=65, NPZP=66

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure_rrfs_conus13km.IN FV3_RUN=rrfs_warm_run.IN INPUT_NML=rrfs_conus13km_hrrr.nml.IN FIELD_TABLE=field_table_thompson_aero_tke_smoke DIAG_TABLE=diag_table_hrrr DIAG_TABLE_ADDITIONAL=diag_additional_rrfs_smoke

RESTART_INTERVAL=1, WARM_START=.true., READ_INCREMENT=.false., RES_LATLON_DYNAMICS=“‘fv3_increment.nc’”

rrfs_smoke_conus13km_hrrr_warm_debug_2threads

HRRR smoke physics on 13km domain, control run

Suite: CCPP_SUITE=FV3_HRRR

Microphysics: IMP_PHYSICS=8

Time Step: DT_ATMOS=120

Set to FALSE: SEDI_SEMI, MAKE_NH, EXTERNAL_IC, NGGPS_IC, LDIAG3D, QDIAG3D, RANDOM_CLDS, CNVCLD, DO_SPPT, DO_SHUM, DO_SKEB, DO_UGWP_*

Set to TRUE: RRFS_SMOKE, SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE

Set to VALUE: DECFL=8, SEAS_OPT=0, LKM=1, ICLIQ_SW=2, IOVR=3, KICE=9, LSM=3, LSOIL_LSM=9, NA_INIT=0, FHZERO=1.0, FHCYC=0.0, IAER=1011, CDMBWD=’3.5,1.0’, LNDP_TYPE=0, N_VAR_LNDP=0, GWD_OPT=3

2021-05-12 16:00:00

1

OUTPUT_GRID=lambert_conformal

Grid Parameters: INPES=$INPES_thrd, JNPES=$JNPES_thrd, INPES=12, JNPES=12, NPX=397, NPY=233, NPZ=65, NPZP=66

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure_rrfs_conus13km.IN FV3_RUN=rrfs_warm_run.IN INPUT_NML=rrfs_conus13km_hrrr.nml.IN FIELD_TABLE=field_table_thompson_aero_tke_smoke DIAG_TABLE=diag_table_hrrr MODEL_CONFIGURE=model_configure_rrfs_conus13km.IN DIAG_TABLE_ADDITIONAL=diag_additional_rrfs_smoke

RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.true, READ_INCREMENT=.false., RES_LATLON_DYNAMICS=“‘fv3_increment.nc’”

rrfs_smoke_conus13km_radar_tten_warm

HRRR smoke physics on 13km domain with radar-derived temperature tendencies

Suite: CCPP_SUITE=FV3_HRRR

Microphysics: IMP_PHYSICS=8

Time Step: DT_ATMOS=120

Set to FALSE: SEDI_SEMI, MAKE_NH, EXTERNAL_IC, NGGPS_IC, LDIAG3D, QDIAG3D, RANDOM_CLDS, CNVCLD, DO_SPPT, DO_SHUM, DO_SKEB, DO_UGWP_*

Set to TRUE: RRFS_SMOKE, SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE

Set to VALUE: FH_DFI_RADAR=’0.0, 0.25, 0.50, 0.75, 1.0’, DECFL=8, SEAS_OPT=0, LKM=1, ICLIQ_SW=2, IOVR=3, KICE=9, LSM=3, LSOIL_LSM=9, NA_INIT=0, FHZERO=1.0, FHCYC=0.0, IAER=1011, CDMBWD=’3.5,1.0’, LNDP_TYPE=0, N_VAR_LNDP=0, GWD_OPT=3

2021-05-12 16:00:00

2

OUTPUT_GRID=lambert_conformal

Grid Parameters: INPES=12, JNPES=12, NPX=397, NPY=233, NPZ=65, NPZP=66

NEMS_CONFIGURE=nems.configure.atm.IN MODEL_CONFIGURE=model_configure_rrfs_conus13km.IN FV3_RUN=rrfs_warm_run.IN INPUT_NML=rrfs_conus13km_hrrr.nml.IN FIELD_TABLE=field_table_thompson_aero_tke DIAG_TABLE=diag_table_hrrr

RESTART_INTERVAL=1, WARM_START=.true, READ_INCREMENT=.false., RES_LATLON_DYNAMICS=“‘fv3_increment.nc’”

Sample CMAKE_FLAGS Setting

export CMAKE_FLAGS="-DAPP=ATM -DCCPP_SUITES=FV3_RAP,FV3_HRRR,FV3_RRFS_v1beta,FV3_RRFS_v1nssl -D32BIT=ON"

Supported Physics Suites

Table 5.8 Physics suites used in the RRFS configurations above

Physics Suite

Description

FV3_RAP

The FV3_RAP physics suite is described in the CCPP documentation here.

FV3_HRRR

The FV3_HRRR physics suite is described in the CCPP documentation here.

FV3_RRFS_v1beta

The FV3_RRFS_v1beta physics suite is described in the CCPP documentation here.

FV3_RRFS_v1nssl

The FV3_RRFS_v1nssl physics suite is similar to the FV3_RRFS_v1beta suite; however, it uses the NSSL 2-moment microphysics scheme instead of the Thompson microphysics scheme.

Additional Information

Input files required for RRFS ATM configurations can be viewed in Table 5.9 or in the UFS WM RT Data Bucket. Users who wish to run additional (unsupported) cases may also find useful data here.

Information on nems.configure files is available in Section 4.2.4. The supported RRFS WM RTs use the same nems.configure file that ATM-only tests do (nems.configure.atm.IN). This file can be viewed in the ufs-weather-model/tests/parm directory here.

Additionally, users can find examples of various RRFS configuration files in ufs-weather-model/tests/parm here. These files include model_configure_*, *_run.IN (input run), *.nml.IN (input namelist), field_table_*, and diag_table_* files.

Table 5.9 Files Required for RRFS RTs

Tests

sfcf*.nc

atmf*.nc

GFSFLX.GrbF*

GFSPRS.GrbF*

Other                                                                         

rrfs_v1beta

sfcf000.nc sfcf009.nc sfcf012.nc

atmf000.nc atmf009.nc atmf012.nc

GFSFLX.GrbF00 GFSFLX.GrbF09 GFSFLX.GrbF12

GFSPRS.GrbF00 GFSPRS.GrbF09 GFSPRS.GrbF12

20210323.060000.coupler.research

20210323.060000.fv_core.res.nc

20210323.060000.fv_core.res.tile[1-6].nc

20210323.060000.fv_srf_wnd.res.tile[1-6].nc

20210323.060000.fv_tracer.res.tile[1-6].nc

20210323.060000.phy_data.tile[1-6].nc

20210323.060000.sfc_data.tile[1-6].nc

rrfs_v1nssl

rrfs_v1nssl_nohailnoccn

sfcf000.nc sfcf009.nc sfcf012.nc

atmf000.nc atmf009.nc atmf012.nc

GFSFLX.GrbF00 GFSFLX.GrbF09 GFSFLX.GrbF12

GFSPRS.GrbF00 GFSPRS.GrbF09 GFSPRS.GrbF12

rrfs_conus13km_hrrr_warm rrfs_smoke_conus13km_hrrr_warm

sfcf000.nc sfcf001.nc sfcf002.nc

atmf000.nc atmf001.nc atmf002.nc

20210512.170000.coupler.res 20210512.170000.fv_core.res.nc 20210512.170000.fv_core.res.tile1.nc 20210512.170000.fv_srf_wnd.res.tile1.nc 20210512.170000.fv_tracer.res.tile1.nc 20210512.170000.phy_data.nc 20210512.170000.sfc_data.nc

rrfs_smoke_conus13km_hrrr_warm_2threads rrfs_smoke_conus13km_radar_tten_warm

sfcf000.nc sfcf001.nc sfcf002.nc

atmf000.nc atmf001.nc atmf002.nc

rrfs_v1beta_debug rrfs_conus13km_hrrr_warm_debug rrfs_smoke_conus13km_hrrr_warm_debug rrfs_smoke_conus13km_hrrr_warm_debug_2threads

sfcf000.nc sfcf001.nc

atmf000.nc atmf001.nc

rrfs_conus13km_hrrr_warm_restart_mismatch

sfcf002.nc

atmf002.nc

5.4. LND

The LND configuration couples DATM, CDEPS, and CMEPS with LND. These tests use default values set in the export_datm_cdeps function of default_vars.sh.

Table 5.10 LND regression test descriptions

Test Name

Description

Physics Suite

DT_ATMOS

Start Date

Forecast Length (hours)

datm_cdeps_lnd_gswp3

DATM_CDEPS_NOAHMP_GSWP3 - control

N/A

N/A

2000-01-01 00:00:00

24

datm_cdeps_lnd_gswp3_rst

DATM_CDEPS_NOAHMP_GSWP3_RST - control restart

N/A

N/A

2000-01-01 12:00:00

12

Sample CMAKE_FLAGS Setting

export CMAKE_FLAGS="-DAPP=LND"

Additional Information

Input files required for LND configurations can be viewed in Section 4.1.9 (LND) or in the UFS WM RT Data Bucket. Information on nems.configure files is available in Section 4.2.4, and a sample ATML nems.configure file (nems.configure.atm_lnd.IN) is available here.

5.5. Seasonal to Subseasonal (S2S) Configurations

COMING SOON!

5.6. NG-GODAS

COMING SOON!

5.7. Hurricane Analysis and Reforecast System Configurations

COMING SOON!