Rename CCPP suites to non-meaningful names

.gitmodules

@@ -4,8 +4,8 @@
   branch = dev/emc
 [submodule "ccpp/framework"]
   path = ccpp/framework
-  url = https://github.com/NCAR/ccpp-framework
-  branch = main
+  url = https://github.com/mkavulich/ccpp-framework
+  branch = feature/suite_names_update
 [submodule "ccpp/physics"]
   path = ccpp/physics
   url = https://github.com/ufs-community/ccpp-physics

ccpp/suites/suite_FV3_RAP.xml → ccpp/suites/albatross.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_RAP" version="1">
+<!--
+DESCRIPTION:
+Suite "albatross" (formerly known as FV3_RAP) was originally developed for research and prototyping of early UFS systems. It was meant to emulate the physics of the Rapid Refresh (RAP) model, though it had some differences from the operational implementation (which was not CCPP-based).
+-->
+<suite name="albatross" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/alias.json

@@ -0,0 +1,43 @@
+{
+    "FV3_HRRR.xml": "bald_eagle.xml",
+    "FV3_GFS_v16.xml": "raven.xml",
+    "FV3_GFS_v15p2.xml": "kingfisher.xml",
+    "FV3_GFS_v17_p8.xml": "bluebird.xml",
+    "FV3_GFS_v17_p8_c3.xml": "parakeet.xml",
+    "FV3_RAP.xml": "albatross.xml",
+    "FV3_RRFS_v1beta.xml": "pigeon.xml",
+    "FV3_RRFS_v1nssl.xml": "crossbill.xml",
+    "FV3_WoFS_v0.xml": "hummingbird.xml",
+    "RRFSens_phy1.xml": "puffin.xml",
+    "RRFSens_phy2.xml": "ptarmigan.xml",
+    "RRFSens_phy3.xml": "chickadee.xml",
+    "RRFSens_phy4.xml": "kestrel.xml",
+    "RRFSens_phy5.xml": "penguin.xml",
+    "FV3_GFS_v15_thompson_mynn_lam3km.xml": "crow.xml",
+    "FV3_GFS_v16_csawmg.xml": "egret.xml",
+    "FV3_GFS_v16_flake.xml": "heron.xml",
+    "FV3_GFS_v16_fv3wam.xml": "loon.xml",
+    "FV3_GFS_v16_ras.xml": "starling.xml",
+    "FV3_GFS_v17_coupled_p8_sfcocn.xml": "dotterel.xml",
+    "FV3_GFS_v17_coupled_p8_ugwpv1.xml": "magpie.xml",
+    "FV3_GFS_v17_coupled_p8.xml": "pelican.xml",
+    "FV3_GFS_v17_p8_mynn.xml": "tern.xml",
+    "FV3_GFS_v17_p8_rrtmgp.xml": "canary.xml",
+    "FV3_GFS_v17_p8_ugwpv1.xml": "condor.xml",
+    "FV3_global_nest_v1.xml": "falcon.xml",
+    "FV3_HAFS_v1_gfdlmp_tedmf_nonsst.xml": "tanager.xml",
+    "FV3_HAFS_v1_gfdlmp_tedmf.xml": "flamingo.xml",
+    "FV3_HAFS_v1_thompson_nonsst.xml": "hornbill.xml",
+    "FV3_HAFS_v1_thompson_tedmf_gfdlsf.xml": "toucan.xml",
+    "FV3_HAFS_v1_thompson.xml": "lorikeet.xml",
+    "FV3_HRRR_c3.xml": "wren.xml",
+    "FV3_HRRR_gf_nogwd.xml": "flycatcher.xml",
+    "FV3_HRRR_gf.xml": "auklet.xml",
+    "FV3_RAP_cires_ugwp.xml": "turnstone.xml",
+    "FV3_RAP_clm_lake.xml": "snowy_owl.xml",
+    "FV3_RAP_flake.xml": "sandpiper.xml",
+    "FV3_RAP_noah_sfcdiff_cires_ugwp.xml": "meadowlark.xml",
+    "FV3_RAP_noah.xml": "dove.xml",
+    "FV3_RAP_sfcdiff.xml": "shrike.xml",
+    "FV3_RAP_unified_ugwp.xml": "ibis.xml"
+}

ccpp/suites/suite_FV3_HRRR_gf.xml → ccpp/suites/auklet.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_HRRR_gf" version="1">
+<!--
+DESCRIPTION:
+Suite "auklet" (formerly known as FV3_HRRR_gf) was used for research and testing for early prototypes of the Rapid Refresh Forecast System (RRFS). Similar to suite "bald_eagle", except with the addition of the Grell-Freitas deep convection scheme and GFS convective cloud diagnostics.
+-->
+<suite name="auklet" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_HRRR.xml → ccpp/suites/bald_eagle.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_HRRR" version="1">
+<!--
+DESCRIPTION:
+Suite "bald_eagle" (formerly known as FV3_HRRR) was originally developed for research and testing for early prototypes of the Rapid Refresh Forecast System (RRFS). It was meant to emulate the physics of the High-Resolution Rapid Refresh (HRRR) model, though it had some differences from the operational implementation (which was not CCPP-based).
+-->
+<suite name="bald_eagle" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v17_p8.xml → ccpp/suites/bluebird.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v17_p8" version="1">
+<!--
+DESCRIPTION:
+Suite "bluebird" (formerly known as FV3_GFS_v17_p8) was used for testing an early prototype of the Global Forecast System (GFS) version 17 release. While it is similar to the physics used for this prototype (P8), it is not identical, and the eventual operational implementation of GFS version 17 will likely be quite different.
+-->
+<suite name="bluebird" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v17_p8_rrtmgp.xml → ccpp/suites/canary.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v17_p8_rrtmgp" version="1">
+<!--
+DESCRIPTION:
+Suite "canary" (formerly known as FV3_GFS_v17_p8_rrtmgp) is a suite used for testing an early prototype of the Global Forecast System (GFS) version 17 release ("Prototype 8"). Similar to "bluebird", but uses RRTMGP: a re-written an parallelized version of the older RRTMG radiation schemes (see https://earth-system-radiation.github.io/rte-rrtmgp/).
+-->
+<suite name="canary" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_RRFSens_phy3.xml → ccpp/suites/chickadee.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="RRFSens_phy3" version="1">
+<!--
+DESCRIPTION:
+Suite "chickadee" (formerly known as RRFSens_phy3) is one of the suites used in early prototypes of the Rapid Refresh Forecast System (RRFS) multi-physics ensemble.
+-->
+<suite name="chickadee" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v17_coupled_p8_ugwpv1.xml → ccpp/suites/condor.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v17_coupled_p8_ugwpv1" version="1">
+<!--
+DESCRIPTION:
+Suite "condor" (formerly known as FV3_GFS_v17_p8_ugwpv1) was used for testing early prototypes of the Global Forecast System (GFS) version 17 release. Identical to suite "bluebird" but with an upgraded version of the unified gravity wave drag physics (v0 -> v1).
+-->
+<suite name="condor" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">
@@ -43,7 +46,6 @@
       <scheme>sfc_nst</scheme>
       <scheme>sfc_nst_post</scheme>
       <scheme>noahmpdrv</scheme>
-      <scheme>sfc_cice</scheme>
       <scheme>sfc_sice</scheme>
       <scheme>GFS_surface_loop_control_part2</scheme>
     </subcycle>

ccpp/suites/suite_FV3_RRFS_v1nssl.xml → ccpp/suites/crossbill.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_RRFS_v1nssl"  version="1">
+<!--
+DESCRIPTION:
+Suite "crossbill" (formerly known as FV3_RRFS_v1nssl) was originally developed for research and development of early prototypes of the Rapid Refresh Forecast System (RRFS), specifically including the NSSL 2-moment cloud microphysics scheme when it was added to CCPP (see https://github.com/NOAA-EMC/fv3atm/pull/472 and https://github.com/NCAR/ccpp-physics/pull/761).
+-->
+<suite name="crossbill"  version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v15_thompson_mynn_lam3km.xml → ccpp/suites/crow.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v15_thompson_mynn_lam3km" version="1">
+<!--
+DESCRIPTION:
+Suite "crow" (formerly known as FV3_GFS_v15_thompson_mynn_lam3km) is an early physics suite used for research and experiments with early high-resolution (3-km) regional UFS grids.
+-->
+<suite name="crow" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v17_coupled_p8_sfcocn.xml → ccpp/suites/dotterel.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v17_coupled_p8_sfcocn" version="1">
+<!--
+DESCRIPTION:
+Suite "dotterel" (formerly known as FV3_GFS_v17_coupled_p8_sfcocn) was used for testing an early prototype of the Global Forecast System (GFS) version 17 release. Similar to suite "pelican", except with a modified near-sea-surface temperature scheme (sfc_ocean) for use with GRIB2 input data.
+-->
+<suite name="dotterel" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_RAP_noah.xml → ccpp/suites/dove.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_RAP_noah" version="1">
+<!--
+DESCRIPTION:
+Suite "dove" (formerly known as FV3_RAP_noah) was originally developed for research and prototyping of early UFS systems. Similar to "albatross", except using the Noah Land Surface Model (instead of RUC LSM) and the GFS surface sea-ice model.
+-->
+<suite name="dove" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v16_csawmg.xml → ccpp/suites/egret.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v16_csawmg" version="1">
+<!--
+DESCRIPTION:
+Suite "egret" (formerly known as FV3_GFS_v16_csawmg) was a suite added for experiments with the Morrison-Gettelman version 3 microphysics.
+-->
+<suite name="egret" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_global_nest_v1.xml → ccpp/suites/falcon.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_global_nest_v1" version="1">
+<!--
+DESCRIPTION:
+Suite "falcon" (formerly known as FV3_global_nest_v1) is a suite that was developed for forecasting atmospheric rivers for the Water in the West project.
+-->
+<suite name="falcon" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_HAFS_v1_gfdlmp_tedmf.xml → ccpp/suites/flamingo.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_HAFS_v1_gfdlmp_tedmf" version="1">
+<!--
+DESCRIPTION:
+Suite "flamingo" (formerly known as FV3_HAFS_v1_gfdlmp_tedmf) is the physics suite used by the operational HAFS-A configuration. When using GRIB2 input data, use suite "tanager" instead.
+-->
+<suite name="flamingo" version="1">
   <!-- <init></init> -->
   <group name="fast_physics">
     <subcycle loop="1">

ccpp/suites/suite_FV3_HRRR_gf_nogwd.xml → ccpp/suites/flycatcher.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_HRRR_gf_nogwd" version="1">
+<!--
+DESCRIPTION:
+Suite "flycatcher" (formerly known as FV3_HRRR_gf_nogwd) is a suite developed for a prototype of the Rapid Refresh Forecast System (RRFS) for fire weather prediction. Similar to suite "auklet", except without gravity wave drag parameterization.
+-->
+<suite name="flycatcher" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v16_flake.xml → ccpp/suites/heron.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v16_flake" version="1">
+<!--
+DESCRIPTION:
+Suite "heron" (formerly known as FV3_GFS_v16_flake) was added to test the capabilities of the Freshwater Lake (FLake) model (http://www.flake.igb-berlin.de/site/doc) for simulating freshwater lake temperatures.
+-->
+<suite name="heron" version="1">
   <!-- <init></init> -->
   <group name="fast_physics">
     <subcycle loop="1">

ccpp/suites/suite_FV3_HAFS_v1_thompson_nonsst.xml → ccpp/suites/hornbill.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_HAFS_v1_thompson_nonsst" version="1">
+<!--
+DESCRIPTION:
+Suite "hornbill" (formerly known as FV3_HAFS_v1_thompson_nonsst) is similar (though not identical) to the physics suite used by the operational HAFS-B configuration. Identical to suite "lorikeet", except with a modified near-sea-surface temperature scheme (sfc_ocean) for use with GRIB2 input data.
+-->
+<suite name="hornbill" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_WoFS_v0.xml → ccpp/suites/hummingbird.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_WoFS_v0"  version="1">
+<!--
+DESCRIPTION:
+Suite "hummingbird" (formerly known as FV3_WoFS_v0) was used for testing an early prototype of the experimental FV3-based Warn-on-Forecast System (WoFS). Same as suite "crossbill" (formerly known as FV3_RRFS_v1nssl) except with Noah Land Surface Model instead of NoahMP.
+-->
+<suite name="hummingbird"  version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_RAP_unified_ugwp.xml → ccpp/suites/ibis.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_RAP_unified_ugwp" version="1">
+<!--
+DESCRIPTION:
+Suite "ibis" (formerly known as FV3_RAP_unified_ugwp) is similar to "albatross" but using the unified gravity wave drag scheme (version 0) rather than the GSL orographic gravity wave drag scheme.
+-->
+<suite name="ibis" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_RRFSens_phy4.xml → ccpp/suites/kestrel.xml

@@ -1,6 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="RRFSens_phy4" version="1">
+<!--
+DESCRIPTION:
+Suite "kestrel" (formerly known as RRFSens_phy4) is one of the suites used in early prototypes of the Rapid Refresh Forecast System (R
+RFS) multi-physics ensemble.
+-->
+<suite name="kestrel" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v15p2.xml → ccpp/suites/kingfisher.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v15p2" version="1">
+<!--
+DESCRIPTION:
+Suite "kingfisher" (formerly known as FV3_GFS_v15p2) was originally developed for research and prototyping of early UFS systems. It was meant to emulate the operational GFS v15.2 physics, though it had some differences from the operational implementation (which was not CCPP-based).
+-->
+<suite name="kingfisher" version="1">
   <!-- <init></init> -->
   <group name="fast_physics">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v16_fv3wam.xml → ccpp/suites/loon.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v16_fv3wam" version="1">
+<!--
+DESCRIPTION:
+Suite "loon" (formerly known as FV3_GFS_v16_fv3wam) was originally developed for early prototypes of the FV3-based Whole Atmosphere Model (WAM).
+-->
+<suite name="loon" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_HAFS_v1_thompson.xml → ccpp/suites/lorikeet.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_HAFS_v1_thompson" version="1">
+<!--
+DESCRIPTION:
+Suite "lorikeet" (formerly known as FV3_HAFS_v1_thompson) is similar (though not identical) to the physics suite used by the operational HAFS-B configuration. When using GRIB2 input data, or coupled with an ocean model, use suite "hornbill" instead.
+-->
+<suite name="lorikeet" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v17_p8_ugwpv1.xml → ccpp/suites/magpie.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v17_p8_ugwpv1" version="1">
+<!--
+DESCRIPTION:
+Suite "magpie" (formerly known as FV3_GFS_v17_coupled_p8_ugwpv1) was originally developed for use by the GFS v17 High-resolution prototype 3 (HR3). While it acccurately represents the physics suite used for this prototype, the eventual implementation of the operational GFS version 17 will likely be different.
+-->
+<suite name="magpie" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">
@@ -43,6 +46,7 @@
       <scheme>sfc_nst</scheme>
       <scheme>sfc_nst_post</scheme>
       <scheme>noahmpdrv</scheme>
+      <scheme>sfc_cice</scheme>
       <scheme>sfc_sice</scheme>
       <scheme>GFS_surface_loop_control_part2</scheme>
     </subcycle>

ccpp/suites/suite_FV3_RAP_noah_sfcdiff_cires_ugwp.xml → ccpp/suites/meadowlark.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_RAP_noah_sfcdiff_cires_ugwp" version="1">
+<!--
+DESCRIPTION:
+Suite "meadowlark" (formerly known as FV3_RAP_noah_sfcdiff_cires_ugwp) was originally developed for research and prototyping of early UFS systems. Designed to emulate the RAP physics, but with several differences, including the surface scheme, land surface model, and gravity wave parameterizations.
+-->
+<suite name="meadowlark" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v17_p8_c3.xml → ccpp/suites/parakeet.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v17_p8_c3" version="1">
+<!--
+DESCRIPTION:
+Suite "parakeet" (formerly known as FV3_GFS_v17_p8_c3) was used for testing an early prototype of the Global Forecast System (GFS) version 17 release. While it is similar to the physics used for this prototype (P8), it is not identical, and the eventual operational implementation of GFS version 17 will likely be quite different.
+-->
+<suite name="parakeet" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">

ccpp/suites/suite_FV3_GFS_v17_coupled_p8.xml → ccpp/suites/pelican.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<suite name="FV3_GFS_v17_coupled_p8" version="1">
+<!--
+DESCRIPTION:
+Suite "pelican" (formerly known as FV3_GFS_v17_coupled_p8) was used for testing an early prototype of the Global Forecast System (GFS) version 17 release. While it is similar to the physics used for this prototype (P8), it is not identical, and the eventual operational implementation of GFS version 17 will likely be quite different. Identical to suite "bluebird", except with the "sfc_cice" physics routine used for coupling with the Community Ice Code (CICE) sea-ice model (https://www.cesm.ucar.edu/models/cice).
+-->
+<suite name="pelican" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
     <subcycle loop="1">