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).
| Configuration Category | Description |
|---|---|
| :ref:`ATM <atm-documented>` | Standalone Atmospheric Model (:term:`ATM`) |
| :ref:`ATML <atml-documented>` | Coupled :term:`ATM` and :term:`LND` |
| :ref:`LND <lnd-documented>` | Coupled :term:`CDEPS` - :term:`DATM` - :term:`LND` -:term:`CMEPS` |
| :ref:`RRFS <rrfs-documented>` | :term:`ATM` with :term:`data assimilation` |
This chapter details the supported build/run options for each supported configuration.
Click on the configuration category in :numref:`Table %s <UFS-configurations-documented>`
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.
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. :numref:`Table %s <def-funcs>` describes what each function does.
| 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 (:term:`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 (:term:`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.
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).
The standalone atmospheric model (:term:`ATM`) is an :term:`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. :numref:`Table %s <atm-rts>` contains a small selection of ATM-only RTs; it will be expanded to cover the full range of ATM-only supported configurations in time:
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
Physics suites used in the ATM configurations above| Physics Suite | Description |
|---|---|
| FV3_GFS_v16 | The :term:`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 :numref:`Section %s <atm-io>`
or in the UFS WM RT Data Bucket.
Information on nems.configure files is available in :numref:`Section %s <nems-conf>`,
and a sample ATM nems.configure file (nems.configure.atm.IN) is available
here.
COMING SOON!
COMING SOON!
COMING SOON!
The ATML configuration couples :term:`ATM` with :term:`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.
| 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
Physics suites used in the ATM configurations above| Physics Suite | Description |
|---|---|
| FV3_GFS_v17_p8 | The :term:`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 :numref:`Section %s (ATM) <atm-io>`
and :numref:`Section %s (LND) <lnd-io>` or in the UFS WM RT Data Bucket.
Information on nems.configure files is available in :numref:`Section %s <nems-conf>`,
and a sample ATML nems.configure file (nems.configure.atm_lnd.IN) is available
here.
The RRFS configurations use an :term:`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. :numref:`Table %s <rrfs-rts>` 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 :numref:`Table %s <rrfs-rts>` details physics settings that differ from both the default_vars.sh values and these RRFS-specific defaults.
| 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 |
| 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
Physics suites used in the RRFS configurations above| Physics Suite | Description |
|---|---|
| FV3_RAP | The FV3_RAP physics suite is described in the :term:`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 :numref:`Table %s <rrfs-files>` 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 :numref:`Section %s <nems-conf>`. 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.
| 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 |
The LND configuration couples :term:`DATM`, :term:`CDEPS`, and :term:`CMEPS` with :term:`LND`. These tests use default values set in the export_datm_cdeps function of default_vars.sh.
| 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 :numref:`Section %s (LND) <lnd-io>`
or in the UFS WM RT Data Bucket.
Information on nems.configure files is available in :numref:`Section %s <nems-conf>`,
and a sample ATML nems.configure file (nems.configure.atm_lnd.IN) is available
here.
COMING SOON!
COMING SOON!
COMING SOON!