diff --git a/doc/UsersGuide/build/.gitignore b/doc/UsersGuide/build/.gitignore deleted file mode 100644 index 0addfc818b..0000000000 --- a/doc/UsersGuide/build/.gitignore +++ /dev/null @@ -1,4 +0,0 @@ -# Ignore everything in this directory -* -# Except this file -!.gitignore diff --git a/doc/UsersGuide/source/Configurations.rst b/doc/UsersGuide/source/Configurations.rst index a19df6d812..ae7772a25b 100644 --- a/doc/UsersGuide/source/Configurations.rst +++ b/doc/UsersGuide/source/Configurations.rst @@ -1,3 +1,9 @@ +.. |nbsp| unicode:: 0xA0 + :trim: + +.. role:: raw-html(raw) + :format: html + .. _Configurations: ************************* @@ -30,6 +36,8 @@ and `rt.gnu.conf ` - Coupled :term:`CDEPS` - :term:`DATM` - :term:`LND` -:term:`CMEPS` + * - :ref:`RRFS ` + - :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 ` @@ -45,7 +53,7 @@ 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 variables; these values will override +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): @@ -138,7 +146,7 @@ it will be expanded to cover the full range of ATM-only supported configurations * - Test Name - Description - - Physics Suite + - Physics Suite (see namelist options `here `__) - DT_ATMOS - Start Date - Forecast Length (hours) @@ -230,7 +238,7 @@ These tests use default values set in the ``export_fv3`` function of ``default_v * - Test Name - Description - - Physics Suite + - Physics Suite (see namelist options `here `__) - DT_ATMOS - Start Date - Forecast Length (hours) @@ -268,6 +276,438 @@ and a sample ATML ``nems.configure`` file (``nems.configure.atm_lnd.IN``) is ava `here `__. +.. _rrfs-documented: + +======================================= +Rapid Refresh Forecast System (RRFS) +======================================= + +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 ` 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 ` details physics settings that differ from both the ``default_vars.sh`` values and these RRFS-specific defaults. + + +.. _rrfs-rts: + +.. list-table:: *RRFS regression test descriptions* + :widths: 50 10 30 50 10 10 10 10 10 + :header-rows: 1 + + * - Test |nbsp| Name |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| + - Description + - General Physics Parameters + - Detailed |nbsp| Physics |nbsp| Parameters |nbsp| (see |nbsp| namelist |nbsp| options |nbsp| `here `__ |nbsp| for variable definitions) + - Start |nbsp| Date |nbsp| |nbsp| |nbsp| |nbsp| + - 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 :raw-html:`

` + **Set to TRUE:** LRADAR, LTAEROSOL :raw-html:`

` + **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 :raw-html:`

` + **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 :raw-html:`

` + **Set to TRUE:** LRADAR, LTAEROSOL :raw-html:`

` + **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 :raw-html:`

` + **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 :raw-html:`

` + **Set to TRUE:** NSSL_CCN_ON, NSSL_HAIL_ON, NSSL_INVERTCCN :raw-html:`

` + **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 :raw-html:`

` + **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 :raw-html:`

` + **Set to TRUE:** NSSL_INVERTCCN :raw-html:`

` + **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 :raw-html:`

` + **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_* :raw-html:`

` + + **Set to TRUE:** SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE :raw-html:`

` + + **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 :raw-html:`

` + **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_* :raw-html:`

` + **Set to TRUE:** SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE :raw-html:`

` + **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 :raw-html:`

` + **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_* :raw-html:`

` + **Set to TRUE:** SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE :raw-html:`

` + **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 :raw-html:`

` + **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_* :raw-html:`

` + **Set to TRUE:** RRFS_SMOKE, SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE :raw-html:`

` + **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 :raw-html:`

` + **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_* :raw-html:`

` + **Set to TRUE:** RRFS_SMOKE, SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE :raw-html:`

` + **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 :raw-html:`

` + **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_* :raw-html:`

` + **Set to TRUE:** RRFS_SMOKE, SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE :raw-html:`

` + **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 :raw-html:`

` + **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_* :raw-html:`

` + **Set to TRUE:** RRFS_SMOKE, SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE :raw-html:`

` + **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 :raw-html:`

` + **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_* :raw-html:`

` + **Set to TRUE:** RRFS_SMOKE, SFCLAY_COMPUTE_FLUX, DO_MYJPBL, MOUNTAIN, PRINT_DIFF_PGR, DO_GSL_DRAG_*, FRAC_ICE :raw-html:`

` + **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 :raw-html:`

` + **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** + +.. code-block:: console + + export CMAKE_FLAGS="-DAPP=ATM -DCCPP_SUITES=FV3_RAP,FV3_HRRR,FV3_RRFS_v1beta,FV3_RRFS_v1nssl -D32BIT=ON" + +**Supported Physics Suites** + +.. list-table:: *Physics suites used in the RRFS configurations above* + :widths: 10 50 + :header-rows: 1 + + * - 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 ` +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 `. 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. + +.. _rrfs-files: + +.. list-table:: Files Required for RRFS RTs + :widths: 50 10 10 10 10 110 + :header-rows: 1 + + * - Tests + - sfcf*.nc + - atmf*.nc + - GFSFLX.GrbF* + - GFSPRS.GrbF* + - Other |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| |nbsp| + * - 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 + - + - + - + .. _lnd-documented: ======= diff --git a/doc/UsersGuide/source/Glossary.rst b/doc/UsersGuide/source/Glossary.rst index c325d647c6..55f4aa6848 100644 --- a/doc/UsersGuide/source/Glossary.rst +++ b/doc/UsersGuide/source/Glossary.rst @@ -54,6 +54,9 @@ Glossary cron table Cron is a job scheduler accessed through the command-line on UNIX-like operating systems. It is useful for automating tasks such as regression testing. Cron periodically checks a cron table (aka crontab) to see if any tasks are are ready to execute. If so, it runs them. + data assimilation + Data assimilation is the process of combining observations, model data, and error statistics to achieve the best estimate of the state of a system. One of the major sources of error in weather and climate forecasts is uncertainty related to the initial conditions that are used to generate future predictions. Even the most precise instruments have a small range of unavoidable measurement error, which means that tiny measurement errors (e.g., related to atmospheric conditions and instrument location) can compound over time. These small differences result in very similar forecasts in the short term (i.e., minutes, hours), but they cause widely divergent forecasts in the long term. Errors in weather and climate forecasts can also arise because models are imperfect representations of reality. Data assimilation systems seek to mitigate these problems by combining the most timely observational data with a "first guess" of the atmospheric state (usually a previous forecast) and other sources of data to provide a "best guess" analysis of the atmospheric state to start a weather or climate simulation. When combined with an "ensemble" of model runs (many forecasts with slightly different conditions), data assimilation helps predict a range of possible atmospheric states, giving an overall measure of uncertainty in a given forecast. + DATM DATM is the *Data Atmosphere* component of :term:`CDEPS`. It uses static atmospheric forcing files (derived from observations or previous atmospheric model runs) instead of output from an active atmospheric model. This reduces the complexity and computational cost associated with coupling to an active atmospheric model. The *Data Atmosphere* component is particularly useful when employing computationally intensive Data Assimilation (DA) techniques to update ocean and/or sea ice fields in a coupled model. In general, use of DATM in place of :term:`ATM` can be appropriate when users are running a coupled model and only want certain components of the model to be active. More information about DATM is available in the `CDEPS Documentation `__.