From 4f32a4b5e6b17c85c6abf52ffd5b44a38d250c3b Mon Sep 17 00:00:00 2001 From: Rick Grubin <152905742+rickgrubin-tomorrow@users.noreply.github.com> Date: Mon, 15 Apr 2024 07:21:08 -0600 Subject: [PATCH] Document ATMW / ATMAERO / HAFS WM configurations (#2160) * UFSWM * doc/Userguide * source * conf.py * Configurations.rst * FAQ.rst * InputsOutputs.rst * Introduction.rst --- doc/UsersGuide/source/Configurations.rst | 629 ++++++++++++++++++++++- doc/UsersGuide/source/FAQ.rst | 26 +- doc/UsersGuide/source/InputsOutputs.rst | 2 +- doc/UsersGuide/source/Introduction.rst | 4 +- doc/UsersGuide/source/conf.py | 9 +- 5 files changed, 647 insertions(+), 23 deletions(-) diff --git a/doc/UsersGuide/source/Configurations.rst b/doc/UsersGuide/source/Configurations.rst index 7ac2cf6034..69d659ffa5 100644 --- a/doc/UsersGuide/source/Configurations.rst +++ b/doc/UsersGuide/source/Configurations.rst @@ -13,7 +13,7 @@ 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 `__ file. +supported configurations, view the `rt.conf `__ file. .. attention:: @@ -31,12 +31,18 @@ supported configurations, view the `rt.conf ` - Standalone Atmospheric Model (:term:`ATM`) + * - :ref:`ATMW ` + - Coupled :term:`ATM` and :term:`WW3` + * - :ref:`ATMAERO ` + - Coupled :term:`ATM` and :term:`GOCART` * - :ref:`ATML ` - Coupled :term:`ATM` and :term:`LND` * - :ref:`LND ` - Coupled :term:`CDEPS` - :term:`DATM` - :term:`LND` -:term:`CMEPS` * - :ref:`RRFS ` - :term:`ATM` with :term:`data assimilation` + * - :ref:`HAFS ` + - Coupled components may include :term:`CDEPS` - :term:`ATM` - :term:`HYCOM` - :term:`WW3` - :term:`MOM6` - :term:`CMEPS` This chapter details the supported build/run options for each supported configuration. Click on the configuration category in :numref:`Table %s ` @@ -200,16 +206,132 @@ Information on ``ufs.configure`` files is available in :numref:`Section %s `__. +.. _atmw-documented: ATMW ======= -**COMING SOON!** +The ATMW configuration couples :term:`ATM` with :term:`WaveWatch III`. +These tests use default values set in the ``export_fv3`` function of ``default_vars.sh``. + +.. list-table:: *ATMW 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 `here `__ |nbsp| for variable definitions) + - Start |nbsp| Date |nbsp| |nbsp| |nbsp| |nbsp| + - Fcst Length (hours) + - Output Grid + - Configuration Files + - Other + * - `atmwav_control_noaero_p8 `__ + - Compare global control results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_GFS_v16" :raw-html:`

` + + **Microphysics:** IMP_PHYSICS=8 :raw-html:`

` + + **Time Step:** DT_ATMOS=720 :raw-html:`

` + + - **Set to FALSE:** LHEATSTRG, DO_UGWP_V1, DO_GSL_DRAG_LS_BL, DO_GSL_DRAG_TOFD, DO_UGWP_V1_OROG_ONLY, DO_UGWP_V0_NST_ONLY, LDIAG_UGWP, CA_GLOBAL, LANDICE, LGFDLMPRAD, DO_SAT_ADJ, MULTIGRID, USE_CICE_ALB, DO_RRTMGP :raw-html:`

` + **Set to TRUE:** USE_MERRA2, LSEASPRAY, DO_UGWP_V0, DO_GSL_DRAG_SS, DO_CA, CA_SGS, CA_TRIGGER, TILEDFIX, CPL, CPLWAV, CPLWAV2ATM, FRAC_GRID, WRITE_NSFLIP, DOGP_CLDOPTICS_LUT, DOGP_LWSCAT, DOGP_SGS_CNV, SATMEDMF :raw-html:`

` + **Set to VALUE:** IALB=2, IEMS=2, LSM=2, IOPT_DVEG=4, IOPT_CRS=2, IOPT_RAD=3, IOPT_ALB=1, IOPT_STC=3, IOPT_SFC=3, IOPT_TRS=2, IOPT_DIAG=2, D2_BG_K1=0.20, D2_BG_K2=0.04, PSM_BC=1, DDDMP=0.1, IAER=1011, KNOB_UGWP_VERSION=0, KNOB_UGWP_NSLOPE=1, NCA=1, NCELLS=5, NLIVES=12, NTHRESH=18, NSEED=1, NFRACSEED=0.5, NSPINUP=1, ISEED_CA=12345, FSICL=0, FSICS=0, DNATS=0, DZ_MIN=6, cap_dbug_flag=0, MIN_SEAICE=0.15, + - 2021-03-22 06:00:00 + - 12 + - OUTPUT_GRID=gaussian_grid :raw-html:`

` + **Grid Parameters**: INPES=$INPES_cpl_atmw, JNPES=$JNPES_cpl_atmw, NPZ=127, NPZP=128 + - FIELD_TABLE=field_table_thompson_noaero_tke + DIAG_TABLE=diag_table_p8_template + INPUT_NML=cpld_control.nml.IN + UFS_CONFIGURE=ufs.configure.atmw.IN + FV3_RUN=control_run.IN + - RUNTYPE=startup, med_model=cmeps, atm_model=fv3, wav_model=ww3 + +.. _atmaero-documented: ATMAERO ========= -**COMING SOON!** +The ATMAERO configuration couples :term:`ATM` with :term:`GOCART`. +These tests use default values set in the ``export_fv3`` function of ``default_vars.sh``. + +.. 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: + + General Physics Parameters: + * **Suite:** CCPP_SUITE= `FV3_GFS_v17_p8 `__ + * **Microphysics:** IMP_PHYSICS=8 + * **Time Step:** DT_ATMOS=720 + + Detailed Physics Parameters: + * **Set to FALSE:** DO_UGWP_V1, DO_GSL_DRAG_LS_BL, DO_GSL_DRAG_TOFD, DO_UGWP_V1_OROG_ONLY, DO_UGWP_V0_NST_ONLY, LDIAG_UGWP, CA_GLOBAL, LANDICE, LGFDLMPRAD, DO_SAT_ADJ, USE_CICE_ALB, DO_RRTMGP + * **Set to TRUE:** WRITE_DOPOST, CPL, CPLCHM, USE_MERRA2, LSEASPRAY, DO_UGWP_V0, DO_GSL_DRAG_SS, DO_CA, CA_SGS, CA_TRIGGER, TILEDFIX, FRAC_GRID, WRITE_NSFLIP, DOGP_CLDOPTICS_LUT, DOGP_LWSCAT, DOGP_SGS_CNV, SATMEDMF + * **Set to VALUE:** NSTF_NAME='2,0,0,0,0', atm_model='fv3', chm_model='gocart', DOMAINS_STACK_SIZE=8000000, IALB=2, IEMS=2, LSM=2, IOPT_DVEG=4, IOPT_CRS=2, IOPT_RAD=3, IOPT_ALB=1, IOPT_STC=3, IOPT_SFC=3, IOPT_TRS=2, IOPT_DIAG=2, D2_BG_K1=0.20, D2_BG_K2=0.04, PSM_BC=1, DDDMP=0.1, GWD_OPT=2, KNOB_UGWP_VERSION=0, KNOB_UGWP_NSLOPE=1, NCA=1, NCELLS=5, NLIVES=12, NTHRESH=18, NSEED=1, NFRACSEED=0.5, NSPINUP=1, ISEED_CA=12345, FSICL=0, FSICS=0, DZ_MIN=6, MIN_SEAICE=0.15 + + The "Detailed Physics Parameters" column in :numref:`Table %s ` details physics settings that differ from both the ``default_vars.sh`` values and these ATMAERO-specific defaults. + +.. _atmaero-rts: + +.. list-table:: *ATMAERO regression test descriptions* + :widths: 50 10 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 + - Detailed |nbsp| Physics |nbsp| Parameters |nbsp| (see |nbsp| namelist |nbsp| options `here `__ |nbsp| for variable definitions) + - Start |nbsp| Date |nbsp| |nbsp| |nbsp| |nbsp| + - Fcst Length (hours) + - Output Grid + - Configuration Files + - Other + * - `atmaero_control_p8 `__ + - Compare global results for prognostic aerosols with previous trunk version + - **Set to FALSE:** LHEATSTRG :raw-html:`

` + **Set to TRUE:** ATMAERO default values only :raw-html:`

` + **Set to VALUE:** IAER=1011, DNATS=2 + - 2021-03-22 06:00:00 + - 24 + - OUTPUT_GRID=gaussian_grid :raw-html:`

` + **Grid Parameters**: INPES=${INPES_atmaero}, JNPES=${JNPES_atmaero}, NPZ=127, NPZP=128 + - FIELD_TABLE=field_table_thompson_noaero_tke_GOCART + DIAG_TABLE=diag_table_cpld.IN + INPUT_NML=ufs.configure.atmaero_esmf.IN + UFS_CONFIGURE=ufs.configure.atmaero.IN + FV3_RUN=control_run.IN + - RESTART_INTERVAL=12 -1 + * - `atmaero_control_p8_rad `__ + - Compare global results for prognostic aerosols with previous trunk version + - **Set to FALSE:** ATMAERO values only :raw-html:`

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

` + **Set to VALUE:** IAER=2011, DNATS=2 + - 2021-03-22 06:00:00 + - 24 + - OUTPUT_GRID=gaussian_grid :raw-html:`

` + **Grid Parameters**: NPZ=127, NPZP=128 + - FIELD_TABLE=field_table_thompson_noaero_tke_GOCART + DIAG_TABLE=diag_table_cpld.IN + INPUT_NML=cpld_control.nml.IN + UFS_CONFIGURE=ufs.configure.atmaero_esmf.IN + FV3_RUN=control_run.IN + - RESTART_INTERVAL=12 -1 + * - `atmaero_control_p8_rad_micro `__ + - Compare global results for prognostic aerosols with previous trunk version + - **Set to FALSE:** :raw-html:`

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

` + **Set to VALUE:** IAER=2011, DNATS=4 + - 2021-03-22 06:00:00 + - 24 + - OUTPUT_GRID=gaussian_grid :raw-html:`

` + **Grid Parameters**: NPZ=127, NPZP=128 + - FIELD_TABLE=field_table_thompson_noaero_tke_GOCART + DIAG_TABLE=diag_table_p8_gocart_micro + INPUT_NML=merra2_thompson.nml.IN + UFS_CONFIGURE=ufs.configure.atmaero_esmf.IN + FV3_RUN=control_run.IN + - RESTART_INTERVAL='12 -1' ATMAQ ======= @@ -335,7 +457,7 @@ Each test file lists the input files required for a given test. Input files requ Information on ``ufs.configure`` files is available in :numref:`Section %s `. The supported RRFS WM RTs use the same ``ufs.configure`` file that ATM-only tests do (``ufs.configure.atm.IN``). This file can be viewed in the ``ufs-weather-model/tests/parm`` `directory `__. -Additionally, users can find examples of various RRFS configuration files in the ``ufs-weather-model/tests/parm`` `directory `__. These files include ``model_configure_*``, ``*_run.IN`` (input run), ``*.nml.IN`` (input namelist), ``field_table_*``, and ``diag_table_*`` files. +Additionally, users can find examples of various RRFS configuration files in the ``ufs-weather-model/tests/parm`` `directory `__. These files include ``model_configure_*``, ``*_run.IN`` (input run), ``*.nml.IN`` (input namelist), ``field_table_*``, and ``diag_table_*`` files. .. _lnd-documented: @@ -397,13 +519,510 @@ NG-GODAS **COMING SOON!** +.. _hafs-documented: + ======================================================== Hurricane Analysis and Reforecast System Configurations ======================================================== -**COMING SOON!** +The HAFS configuration uses an :term:`DATM`-only configuration. + +These tests use the default values set in the ``export_fv3``, ``export_hafs``, ``export_hafs_regional``, ``export_hafs_datm_cdeps``, and ``export_hafs_docn_cdeps`` functions of ``default_vars.sh`` unless other values are explicitly set in a given test file. In all tests, the values in ``export_fv3`` are set first. + +.. note:: + + ``export_hafs`` calls ``export_hafs_regional``, which calls ``export_hafs_datm_cdeps`` or ``export_hafs_docn_cdeps``, which calls ``export_fv3``. Values from ``export_fv3`` are set first, followed by values in ``export_hafs``, ``export_hafs_regional``, and then values in ``export_hafs_datm_cdeps`` or ``export_hafs_docn_cdeps``. + + +.. list-table:: *Default physics-related variables used in the HAFS configurations below* + :widths: 10 50 + :header-rows: 1 + * - Export Function + - Variables + * - export_hafs + - **Set to FALSE:** S2S, AQM, DATM_CDEPS, DOCN_CDEPS, HYBEDMF, CNVGWD, LTAEROSOL, LHEATSTRG, IS_MOVING_NEST :raw-html:`

` + **Set to TRUE:** FV3, HAFS, SATMEDMF, HURR_PBL, DO_GSL_DRAG_LS_BL, DO_GSL_DRAG_SS, DO_GSL_DRAG_TOFD, LRADAR, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** NTILES=1, IMFSHALCNV=2, IMFDEEPCNV=2, MONINQ_FAC=-1.0, ISATMEDMF=1, IOPT_SFC=1, IOPT_DVEG=2, IOPT_CRS=1, IOPT_RAD=1, IOPT_ALB=2, IOPT_STC=1, LSM=1, IMP_PHYSICS=11, IAER=111, CDMBWD=1.0,1.0,1.0,1.0, FV_CORE_TAU=5., RF_CUTOFF=30.e2, RF_CUTOFF_NEST=50.e2, VORTEX_TRACKER=0, NTRACK=0, MOVE_CD_X=0, MOVE_CD_Y=0, NFHOUT=3, NFHMAX_HF=-1, NFHOUT_HF=3, NSOUT=-1, OUTPUT_FH=-1 + * - export_hafs_regional + - **Set to FALSE:** S2S, AQM, DOCN_CDEPS, WRITE_DOPOST, USE_COLDSTART, MULTIGRID :raw-html:`

` + **Set to TRUE:** FV3, HAFS, CPL, QUILTING, OUTPUT_HISTORY, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** NTILES=1, FHMAX=6, ENS_NUM=1, DT_ATMOS=900, RESTART_INTERVAL=0, FHROT=0, coupling_interval_fast_sec=0, WRITE_GROUP=1, WRTTASK_PER_GROUP=6, NUM_FILES=2, FILENAME_BASE="'atm' 'sfc'", OUTPUT_GRID="'regional_latlon'", OUTPUT_FILE="'netcdf'", IDEFLATE=0, QUANTIZE_NSD=0, NFHOUT=3, NFHMAX_HF=-1, NFHOUT_HF=3, CEN_LON=-62.0, CEN_LAT=25.0, LON1=-114.5, LAT1=-5.0, LON2=-9.5, LAT2=55.0, DLON=0.03, DLAT=0.03, DIAG_TABLE=diag_table_hafs, FIELD_TABLE=field_table_hafs, WW3OUTDTHR=3, OUTPARS_WAV="WND HS T01 T02 DIR FP DP PHS PTP PDIR UST CHA USP", WAV_CUR='C', med_model=cmeps, pio_rearranger=box, CAP_DBUG_FLAG=0, CPLMODE=hafs, RUNTYPE=startup, MESH_WAV=mesh.hafs.nc, MODDEF_WAV=mod_def.natl_6m + * - export_hafs_datm_cdeps + - **Set to FALSE:** FV3, S2S, AQM, DOCN_CDEPS :raw-html:`

` + **Set to TRUE:** HAFS, DATM_CDEPS :raw-html:`

` + **Set to VALUE:** NTILES=1, atm_model=datm, DATM_IN_CONFIGURE=datm_in, DATM_STREAM_CONFIGURE=hafs_datm.streams.era5.IN + * - export_hafs_docn_cdeps + - **Set to FALSE:** S2S, AQM :raw-html:`

` + **Set to TRUE:** FV3, HAFS, DOCN_CDEPS :raw-html:`

` + **Set to VALUE:** NTILES=1, ocn_model=docn, ocn_datamode=sstdata, pio_rearranger=box, DOCN_IN_CONFIGURE=docn_in, DOCN_STREAM_CONFIGURE=hafs_docn.streams.IN + +.. _hafs-rts: + +.. list-table:: *HAFS 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 `here `__ |nbsp| for variable definitions) + - Start |nbsp| Date |nbsp| |nbsp| |nbsp| |nbsp| + - Fcst Length (hours) + - Output Grid + - Configuration Files + - Other + * - `rhafs_global_1nest_atm `__ + - Compare HAFS global with 1 nest and atmosphere only results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=90 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, CPLFLX, CPLWAV, CPLWAV2ATM, CPL_IMP_MRG, CMEPS, USE_COLDSTART :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, CPLOCN2ATM, NESTED :raw-html:`

` + **Set to VALUE:** + See ``export_hafs`` default values. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=global_latlon, OUTPUT_GRID_2=rotated_latlon :raw-html:`

` + **Grid Parameters**: INPES=4, JNPES=5, NPX=97, NPY=97, NPZ=64, NPZP=$(($NPZ + 1)), INPES_NEST02=6, JNPES_NEST02=10, NPX_NEST02=241, NPY_NEST02=241 + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_global_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm.IN" + FV3_RUN="hafs_fv3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_global_multiple_4nests_atm `__ + - Compare HAFS global with 4 multiple nests and atmosphere only results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=90 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, CPLFLX, CPLWAV, CPLWAV2ATM, CPL_IMP_MRG, CMEPS, USE_COLDSTART :raw-html:`

` + **Set to TRUE:** WRITE_DOPOST, EXTERNAL_IC, NGGPS_IC, CPLOCN2ATM, NESTED :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs default values. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=global_latlon, OUTPUT_GRID_2=regional_latlon, OUTPUT_GRID_3=rotated_latlon, OUTPUT_GRID_4=rotated_latlon, OUTPUT_GRID_5=rotated_latlon :raw-html:`

` + **Grid Parameters**: INPES=4, JNPES=5, NPX=97, NPY=97, NPZ=64, NPZP=$(($NPZ + 1)), INPES_NEST02=6, JNPES_NEST02=10, NPX_NEST02=241, NPY_NEST02=241, INPES_NEST03=6, JNPES_NEST03=10, NPX_NEST03=241, NPY_NEST03=241, INPES_NEST04=6, JNPES_NEST04=10, NPX_NEST04=361, NPY_NEST04=361, INPES_NEST05=6, JNPES_NEST05=10, NPX_NEST05=361, NPY_NEST05=361 + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_global_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + INPUT_NEST03_NML=input_nest_hafs.nml.IN + INPUT_NEST04_NML=input_nest_hafs.nml.IN + INPUT_NEST05_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm.IN" + FV3_RUN="hafs_fv3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_global_storm_following_1nest_atm `__ + - Compare HAFS global with 1 storm-following moving nest and atmosphere only results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, IS_MOVING_NEST=".false.,.true.", CPLFLX, CPLWAV, CPLWAV2ATM, CPL_IMP_MRG, CMEPS, USE_COLDSTART :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, CPLOCN2ATM, NESTED :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs default values. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=global_latlon, OUTPUT_GRID_2=rotated_latlon :raw-html:`

` + **Grid Parameters**: INPES=4, JNPES=5, NPX=97, NPY=97, NPZ=64, NPZP=$(($NPZ + 1)), INPES_NEST02=6, JNPES_NEST02=10, NPX_NEST02=73, NPY_NEST02=73 + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_global_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm.IN" + FV3_RUN="hafs_fv3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_1nest_atm `__ + - Compare HAFS regional with 1 nest and atmosphere only results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=90 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, CPLFLX, CPLWAV, CPLWAV2ATM, CPL_IMP_MRG, CMEPS, USE_COLDSTART :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLOCN2ATM, NESTED :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs default values. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=rotated_latlon, OUTPUT_GRID_2=rotated_latlon :raw-html:`

` + **Grid Parameters**: INPES=6, JNPES=10, NPX=241, NPY=241, NPZ=64, NPZP=$(($NPZ + 1)), INPES_NEST02=6, JNPES_NEST02=10, NPX_NEST02=361, NPY_NEST02=361 + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm.IN" + FV3_RUN="hafs_fv3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_atm `__ + - Compare HAFS regional atmosphere only results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, CPLFLX, CPLWAV, CPLWAV2ATM, CPL_IMP_MRG, CMEPS, USE_COLDSTART :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLOCN2ATM :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs default values. + - 2019-08-29 00:00:00 + - 6 + - OUTPUT_GRID=regional_latlon :raw-html:`

` + **Grid Parameters**: INPES=20, JNPES=12, NPX=721, NPY=601, NPZ=91, NPZP=$(($NPZ + 1)) + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm.IN" + FV3_RUN="hafs_fv3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_atm_ocn `__ + - Compare HAFS regional atmosphere-ocean coupled HYCOM results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf_nonsst" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, CPLWAV, CPLWAV2ATM, CDEPS_DOCN :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLFLX, CPLOCN2ATM, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs_regional then export_hafs default values. + - 2019-08-29 00:00:00 + - 6 + - OUTPUT_GRID=regional_latlon :raw-html:`

` + **Grid Parameters**: INPES=20, JNPES=12, NPX=721, NPY=601, NPZ=91, NPZP=$(($NPZ + 1)) + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm_ocn.IN" + FV3_RUN="hafs_fv3_run.IN hycom_hat10_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_atm_ocn_wav `__ + - Compare HAFS regional atmosphere-ocean-wave coupled results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf_nonsst" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, CPLWAV2ATM, CDEPS_DOCN :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLFLX, CPLOCN2ATM, CPLWAV, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs_regional then export_hafs default values. + - 2019-08-29 00:00:00 + - 6 + - OUTPUT_GRID=regional_latlon :raw-html:`

` + **Grid Parameters**: INPES=20, JNPES=12, NPX=721, NPY=601, NPZ=91, NPZP=$(($NPZ + 1)) + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm_ocn_wav.IN" + FV3_RUN="hafs_fv3_run.IN hycom_hat10_run.IN hafs_ww3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_atm_thompson_gfdlsf `__ + - Compare the results from HAFS regional atmosphere only using the Thompson microphysics scheme and GFDL surface layer scheme with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_thompson_tedmf_gfdlsf" + + **Microphysics:** IMP_PHYSICS=8 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, DO_SAT_ADJ, CPLFLX, CPLWAV, CPLWAV2ATM, CPL_IMP_MRG, CMEPS, USE_COLDSTART :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLOCN2ATM :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs default values. + - 2019-08-29 00:00:00 + - 6 + - OUTPUT_GRID=cubed_sphere_grid :raw-html:`

` + **Grid Parameters**: INPES=20, JNPES=12, NPX=721, NPY=601, NPZ=91, NPZP=$(($NPZ + 1)) + - FIELD_TABLE=field_table_hafs_thompson + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm.IN" + FV3_RUN="hafs_fv3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_atm_wav `__ + - Compare HAFS regional atmosphere-wave coupled results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, CPLOCN2ATM, CDEPS_DOCN :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLFLX, CPLWAV, CPLWAV2ATM, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs_regional then export_hafs default values. + - 2019-08-29 00:00:00 + - 6 + - OUTPUT_GRID=regional_latlon :raw-html:`

` + **Grid Parameters**: INPES=20, JNPES=12, NPX=721, NPY=601, NPZ=91, NPZP=$(($NPZ + 1)) + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm_wav.IN" + FV3_RUN="hafs_fv3_run.IN hafs_ww3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_datm_cdeps `__ + - Compare HAFS regional coupled CDEPS data atmosphere from ERA5 with regional HYCOM results with previous trunk version + - N/A: No active atmospheric component + - **Set to FALSE:** CPLWAV, CDEPS_DOCN :raw-html:`

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

` + **Set to VALUE:** + Also, see export_hafs_datm_cdeps then export_hafs_regional then export_hafs default values. + - 2019-08-29 00:00:00 + - 24 + - OUTPUT_GRID=regional_latlon :raw-html:`

` + **Grid Parameters**: INPES=$INPES_dflt, JNPES=$JNPES_dflt + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs + INPUT_NML=input_regional_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm_ocn.IN" + FV3_RUN="hafs_datm_cdeps_era5.IN hycom_hat10_run.IN" + DATM_STREAM_CONFIGURE=hafs_datm.streams.era5.IN + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_docn `__ + - Compare HAFS regional coupled with regional data ocean from MOM6 results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf_nonsst" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, CPLWAV, CPLWAV2ATM :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLFLX, CPLOCN2ATM, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs_docn_cdeps then export_hafs_regional then export_hafs default values. + - 2019-08-29 00:00:00 + - 24 + - OUTPUT_GRID=regional_latlon :raw-html:`

` + **Grid Parameters**: INPES=20, JNPES=12, NPX=721, NPY=601, NPZ=91, NPZP=$(($NPZ + 1)) + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm_docn.IN" + FV3_RUN="hafs_fv3_run.IN hafs_docn_cdeps_mom6.IN" + DOCN_STREAM_CONFIGURE=hafs_docn.streams.IN + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_docn_oisst `__ + - Compare HAFS regional coupled with global data ocean from OISST results with previous trunk version + - **Suite:** CCPP_SUITE=FV3_HAFS_v1_gfdlmp_tedmf_nonsst + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, CPLWAV, CPLWAV2ATM :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLFLX, CPLOCN2ATM, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs_docn_cdeps then export_hafs_regional then export_hafs default values. + - 2019-08-29 00:00:00 + - 6 + - OUTPUT_GRID=regional_latlon :raw-html:`

` + **Grid Parameters**: INPES=20, JNPES=12, NPX=721, NPY=601, NPZ=91, NPZP=$(($NPZ + 1)) + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm_docn.IN" + FV3_RUN="hafs_fv3_run.IN hafs_docn_cdeps_oisst.IN" + DOCN_STREAM_CONFIGURE=hafs_docn.streams.IN + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.true., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_specified_moving_1nest_atm `__ + - Compare HAFS regional with 1 specified moving nest and atmosphere only results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, IS_MOVING_NEST=".false.,.true.", CPLFLX, CPLWAV, CPLWAV2ATM, CPL_IMP_MRG, CMEPS, USE_COLDSTART :raw-html:`

` + **Set to TRUE:** WRITE_DOPOST, EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLOCN2ATM :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs default values. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=rotated_latlon, OUTPUT_GRID_2=rotated_latlon_moving :raw-html:`

` + **Grid Parameters**: INPES=6, JNPES=10, NPX=241, NPY=241, NPZ=64, NPZP=$(($NPZ + 1)), INPES_NEST02=6, JNPES_NEST02=10, NPX_NEST02=361, NPY_NEST02=361 + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm.IN" + FV3_RUN="hafs_fv3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_storm_following_1nest_atm `__ + - Compare HAFS regional with 1 storm-following moving nest and atmosphere only results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, IS_MOVING_NEST=".false.,.true.", CPLFLX, CPLWAV, CPLWAV2ATM, CPL_IMP_MRG, CMEPS, USE_COLDSTART :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLOCN2ATM :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs default values. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=rotated_latlon, OUTPUT_GRID_2=rotated_latlon_moving :raw-html:`

` + **Grid Parameters**: INPES=6, JNPES=10, NPX=241, NPY=241, NPZ=64, NPZP=$(($NPZ + 1)), INPES_NEST02=6, JNPES_NEST02=10, NPX_NEST02=361, NPY_NEST02=361 + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm.IN" + FV3_RUN="hafs_fv3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_storm_following_1nest_atm_ocn `__ + - Compare HAFS regional with 1 storm-following moving nest and atmosphere-ocean coupled results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf_nonsst" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, IS_MOVING_NEST=".false.,.true.", CPLWAV, CPLWAV2ATM, USE_COLDSTART, CDEPS_DOCN :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLFLX, CPLOCN2ATM, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs_regional default values then export_hafs. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=regional_latlon, OUTPUT_GRID_2=regional_latlon_moving :raw-html:`

` + **Grid Parameters**: INPES=6, JNPES=10, NPX=241, NPY=241, NPZ=64, NPZP=$(($NPZ + 1)), INPES_NEST02=6, JNPES_NEST02=10, NPX_NEST02=361, NPY_NEST02=361 + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm_ocn.IN" + FV3_RUN="hafs_fv3_run.IN hycom_hat10_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_storm_following_1nest_atm_ocn_debug `__ + - Compare HAFS regional with 1 storm-following moving nest and atmosphere-ocean coupled results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf_nonsst" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, IS_MOVING_NEST=".false.,.true.", CPLWAV, CPLWAV2ATM, USE_COLDSTART, CDEPS_DOCN :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLFLX, CPLOCN2ATM, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs_regional default values then export_hafs. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=regional_latlon, OUTPUT_GRID_2=regional_latlon_moving :raw-html:`

` + **Grid Parameters**: INPES=6, JNPES=10, NPX=241, NPY=241, NPZ=64, NPZP=$(($NPZ + 1)), INPES_NEST02=6, JNPES_NEST02=10, NPX_NEST02=361, NPY_NEST02=361 + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm_ocn.IN" + FV3_RUN="hafs_fv3_run.IN hycom_hat10_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_storm_following_1nest_atm_ocn_debug `__ + - Compare HAFS regional with 1 storm-following moving nest and atmosphere-ocean coupled results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf_nonsst" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, IS_MOVING_NEST=".false.,.true.", CPLWAV2ATM, USE_COLDSTART, CDEPS_DOCN :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLFLX, CPLOCN2ATM, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs_regional default values then export_hafs. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=regional_latlon, OUTPUT_GRID_2=regional_latlon_moving :raw-html:`

` + **Grid Parameters**: INPES=$INPES_thrd, JNPES=$JNPES_thrd, INPES=6, JNPES=10, NPX=241, NPY=241, NPZ=64, NPZP=$(($NPZ + 1)) + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm_ocn.IN" + FV3_RUN="hafs_fv3_run.IN hycom_hat10_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_storm_following_1nest_atm_ocn_wav `__ + - Compare HAFS regional with 1 storm-following moving nest and atmosphere-ocean-wave coupled results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf_nonsst" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=180 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, IS_MOVING_NEST=".false.,.true.", CPLWAV2ATM, USE_COLDSTART, CDEPS_DOCN :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLFLX, CPLOCN2ATM, CPLWAV, CPL_IMP_MRG :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs_regional default values then export_hafs. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=rotated_latlon, OUTPUT_GRID_2=rotated_latlon :raw-html:`

` + **Grid Parameters**: INPES=6, JNPES=10, NPX=241, NPY=241, NPZ=64, NPZP=$(($NPZ + 1)), INPES_NEST02=6, JNPES_NEST02=10, NPX_NEST02=361, NPY_NEST02=361 + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm_ocn_wav.IN" + FV3_RUN="hafs_fv3_run.IN hycom_hat10_run.IN hafs_ww3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" + * - `hafs_regional_telescopic_2nests_atm `__ + - Compare HAFS regional with two telescopic nests and atmosphere only results with previous trunk version + - **Suite:** CCPP_SUITE="FV3_HAFS_v1_gfdlmp_tedmf" + + **Microphysics:** IMP_PHYSICS=11 + + **Time Step:** DT_ATMOS=90 + - **Set to FALSE:** MOUNTAIN, WARM_START, FULL_ZS_FILTER, CPLFLX, CPLWAV, CPLWAV2ATM, CMEPS, USE_COLDSTART :raw-html:`

` + **Set to TRUE:** EXTERNAL_IC, NGGPS_IC, REGIONAL, CPLOCN2ATM :raw-html:`

` + **Set to VALUE:** + Also, see export_hafs default values. + - 2020-08-25 12:00:00 + - 6 + - OUTPUT_GRID=rotated_latlon, OUTPUT_GRID_2=lambert_conformal, OUTPUT_GRID_3=regional_latlon :raw-html:`

` + **Grid Parameters**: INPES=6, JNPES=10, NPX=241, NPY=241, NPZ=64, NPZP=$(($NPZ + 1)), INPES_NEST02=6, JNPES_NEST02=10, NPX_NEST02=361, NPY_NEST02=361, INPES_NEST03=6, JNPES_NEST03=10, NPX_NEST03=361, NPY_NEST03=361 + - FIELD_TABLE=field_table_hafs + DIAG_TABLE=diag_table_hafs_template + INPUT_NML=input_regional_hafs.nml.IN + INPUT_NEST02_NML=input_nest_hafs.nml.IN + INPUT_NEST03_NML=input_nest_hafs.nml.IN + MODEL_CONFIGURE="model_configure_hafs.IN" + UFS_CONFIGURE="ufs.configure.hafs_atm.IN" + FV3_RUN="hafs_fv3_run.IN" + - RESTART_INTERVAL=1, atm_omp_num_threads=2, WARM_START=.false., READ_INCREMENT=.false., RES_LATLON_DYNAMICS="'fv3_increment.nc'" +**Sample** ``CMAKE_FLAGS`` **Setting** +.. code-block:: console + + export CMAKE_FLAGS="-DAPP=HAFS" +**Supported Physics Suites** + +.. list-table:: *Physics suites used in the HAFS configurations above* + :widths: 10 50 + :header-rows: 1 + + * - Physics Suite + - Description + * - FV3_HAFS_v1_gfdlmp_tedmf + - The FV3_HAFS_v1_gfdlmp_tedmf physics suite is described in the :term:`CCPP` documentation `here `__. + * - FV3_HAFS_v1_gfdlmp_tedmf_nonsst + - The FV3_HAFS_v1_gfdlmp_tedmf_nonsst physics suite is described in the CCPP documentation `here `__. + * - FV3_HAFS_v1_thompson_tedmf_gfdlsf + - The FV3_HAFS_v1_thompson_tedmf_gfdlsf physics suite is described in the CCPP documentation `here `__. diff --git a/doc/UsersGuide/source/FAQ.rst b/doc/UsersGuide/source/FAQ.rst index 236faec8e7..939f057bd6 100644 --- a/doc/UsersGuide/source/FAQ.rst +++ b/doc/UsersGuide/source/FAQ.rst @@ -166,7 +166,7 @@ options: MOM6, CICE6 and CMEPS restart files ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -In ``nems.configure``, set the ALLCOMP_attribute ``restart_n`` to a +In ``ufs.configure``, set the ALLCOMP_attribute ``restart_n`` to a value greater than the forecast length. MOM6 history files @@ -229,11 +229,11 @@ How do I set the total number of tasks for my job? In the UFS WM, each component's MPI task information, including the starting and ending tasks and the number of threads, are specified using the component-specific ``petlist_bounds`` and -``omp_num_threads`` in ``nems.configure``. In general, the total +``omp_num_threads`` in ``ufs.configure``. In general, the total number of MPI tasks required is the sum of all the sub-component tasks, as long as those components do not overlap (i.e., share the same PETs). An example of a global 5 component coupled configuration -nems.configure at the end of this section. +ufs.configure at the end of this section. FV3atm ^^^^^^ @@ -286,7 +286,7 @@ If ESMF-managed threading is used, the total number of PETs for the atmosphere component is given by the product of the number of threads requested and the total number of MPI ranks (both forecast and write grid component). If ``num_threads_atm`` is the number of threads -specified for the FV3atm component, in ``nems.configure`` the ATM PET +specified for the FV3atm component, in ``ufs.configure`` the ATM PET bounds are given by :: @@ -295,7 +295,7 @@ bounds are given by ATM_omp_num_threads num_threads_atm Note that in UWM, the ATM component is normally listed first in -``nems.configure`` so that the starting PET for the ATM is 0. +``ufs.configure`` so that the starting PET for the ATM is 0. GOCART ^^^^^^ @@ -330,7 +330,7 @@ MPI tasks for CMEPS is given by total_tasks_med = smaller of (300, FV3atm forecast tasks) -and in ``nems.configure`` +and in ``ufs.configure`` :: @@ -342,7 +342,7 @@ MOM6 For MOM6 the only restriction currently on the number of MPI ranks used by MOM6 is that it is divisible by 2. The starting PET in -``nems.configure`` will be the last PET of the preceding component, +``ufs.configure`` will be the last PET of the preceding component, incremented by one. Threading in MOM6 is not recommended at this time. :: @@ -388,14 +388,14 @@ For the 1-deg CICE domain for example, ``ice_in`` would be In UFS, only a single thread is used for CICE so for ``nprocs`` set in -``ice_in``, the tasks in ``nems.configure`` are set as: +``ice_in``, the tasks in ``ufs.configure`` are set as: :: ICE_petlist_bounds: starting_ICE_PET nprocs+starting_ICE_PET-1 ICE_omp_num_threads: 1 -The starting ICE PET in ``nems.configure`` will be the last PET of the +The starting ICE PET in ``ufs.configure`` will be the last PET of the preceding component, incremented by one. WW3 @@ -409,20 +409,20 @@ for WW3 and the number of threads to be used. WAV_petlist_bounds: starting_WAV_PET num_tasks_wav*num_threads_wav+starting_WAV_PET-1 WAV_omp_num_threads: num_threads_wav -The starting WAV PET in ``nems.configure`` will be the last PET of the +The starting WAV PET in ``ufs.configure`` will be the last PET of the preceding component, incremented by one. -Example: 5-component nems.configure +Example: 5-component ufs.configure ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -For the fully coupled S2SWA application, a sample ``nems.configure`` is shown below : +For the fully coupled S2SWA application, a sample ``ufs.configure`` is shown below : .. code-block:: console ############################################# - #### NEMS Run-Time Configuration File ##### + #### UFS Run-Time Configuration File ##### ############################################# # ESMF # diff --git a/doc/UsersGuide/source/InputsOutputs.rst b/doc/UsersGuide/source/InputsOutputs.rst index b3b7567fda..fbf767c263 100644 --- a/doc/UsersGuide/source/InputsOutputs.rst +++ b/doc/UsersGuide/source/InputsOutputs.rst @@ -2288,7 +2288,7 @@ on the monthly, daily, hourly, yearly or timestep intervals set by the *histfreq *0* for both monthly and daily frequencies and neither yearly nor per-timestep output is requested, only 6-hour mean history files will be produced. -Further details of the configuration of CICE model output can be found in the CICE documentation `Section 3.1.4 `__. +Further details of the configuration of CICE model output can be found in the CICE documentation `Section 3.1.4 `__. .. _ww3-out: diff --git a/doc/UsersGuide/source/Introduction.rst b/doc/UsersGuide/source/Introduction.rst index 0da2908b2a..b2d86b08c1 100644 --- a/doc/UsersGuide/source/Introduction.rst +++ b/doc/UsersGuide/source/Introduction.rst @@ -47,7 +47,7 @@ The UFS WM code is portable and can be used with Linux or Mac operating systems Those wishing to contribute development to the UFS WM should become familiar with the procedures for running the model as a standalone component and for executing the regression tests described in the UFS WM GitHub `wiki `__ to make sure no inadvertent changes to the results have been introduced during the development process. -Support for the UFS WM is provided through the `UFS Forum `__ by the Developmental Testbed Center (DTC) and other groups involved in UFS development, such as NOAA's Environmental Modeling Center (:term:`EMC`), NOAA research laboratories (GFDL, NSSL, ESRL, and AOML), and :term:`NCAR`. UFS users and developers are encouraged not only to post questions, but also to help address questions posted by other members of the community. +Support for the UFS WM is provided through the `UFS Forum `__ by the Developmental Testbed Center (DTC) and other groups involved in UFS development, such as NOAA's Environmental Modeling Center (:term:`EMC`), NOAA research laboratories (GFDL, NSSL, ESRL, and AOML), and :term:`NCAR`. UFS users and developers are encouraged not only to post questions, but also to help address questions posted by other members of the community. This WM User's Guide is organized as follows: @@ -57,6 +57,8 @@ This WM User's Guide is organized as follows: * :numref:`Chapter %s ` (Data: Input, Model Configuration, and Output Files) lists the model inputs and outputs and has a description of the key files. + * :numref:`Chapter %s ` (Configurations) lists the currently supported configurations for the UFS WM. + * :numref:`Chapter %s ` (Configuration Parameters) lists the purpose and valid values for various configuration parameters. * :numref:`Chapter %s ` (Automated Testing) describes UFS WM automated testing options. diff --git a/doc/UsersGuide/source/conf.py b/doc/UsersGuide/source/conf.py index e7c00bd318..546afb385f 100644 --- a/doc/UsersGuide/source/conf.py +++ b/doc/UsersGuide/source/conf.py @@ -69,9 +69,12 @@ # The master toctree document. master_doc = 'index' -# The language for content autogenerated by Sphinx. -# Not set because default is 'en'. -# language = 'en' +# The language for content autogenerated by Sphinx. Refer to documentation +# for a list of supported languages. +# +# This is also used if you do content translation via gettext catalogs. +# Usually you set "language" from the command line for these cases. +language = 'en' # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files.