From 0c97410b5931612c8623609cd95505c2c51caea4 Mon Sep 17 00:00:00 2001 From: Kate Fossell Date: Tue, 20 Oct 2020 08:22:19 -0600 Subject: [PATCH 1/6] Starting UPP version numbers with 10.0.0 for develop branch --- VERSION | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/VERSION b/VERSION index 64a3d8066..a13e7b9c8 100644 --- a/VERSION +++ b/VERSION @@ -1,3 +1 @@ -9.9.9 -# This is a placeholder version number. -# It will be replaced with an appropriate version following a discussion within the UPP management. +10.0.0 From e1cd80b25ef5796cff3f4507edff7253c63d9164 Mon Sep 17 00:00:00 2001 From: Kate Fossell Date: Thu, 30 Sep 2021 10:59:10 -0600 Subject: [PATCH 2/6] Add codeowners file to develop --- .github/CODEOWNERS | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 .github/CODEOWNERS diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS new file mode 100644 index 000000000..962217602 --- /dev/null +++ b/.github/CODEOWNERS @@ -0,0 +1,14 @@ +# This is a comment. +# Each line is a file pattern followed by one or more owners. + +# These owners will be the default owners for everything in +# the repo. Unless a later match takes precedence, +# @global-owner1 and @global-owner2 will be requested for +# review when someone opens a pull request. +* @WenMeng-NOAA + + +# DTC support for public releases and documentation +docs/* @hertneky @fossell +scripts/run_upp @hertneky @fossell + From 24d62ad39d8a8b0dc94aed4c56724c0a232362aa Mon Sep 17 00:00:00 2001 From: Kate Fossell Date: Mon, 25 Apr 2022 16:20:30 -0500 Subject: [PATCH 3/6] Update README --- README.md | 54 ++++++++++++++++++++++++------------------------------ 1 file changed, 24 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index 4d403a302..c7c3801b2 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ System (GFS), GFS Ensemble Forecast System (GEFS), North American Mesoscale (NAM), Rapid Refresh (RAP), High Resolution Rapid Refresh (HRRR), Short Range Ensemble Forecast (SREF), Hurricane WRF (HWRF) applications, and is also used in Unified Forecasting System (UFS) -applications. +applications (MRW, SRW, and HAFS). The UPP provides the capability to compute a variety of diagnostic fields and interpolate to pressure levels or other vertical @@ -41,13 +41,17 @@ Examples of UPP products include: - Radar reflectivity products - Satellite look-alike products -Support for the UFS UPP is provided through the UFS Forum by the -Developmental Testbed Center (DTC) for FV3-based applications. -For full documentation see https://noaa-emc.github.io/UPP/. +## User Support +Support for the UFS UPP is provided through the [UFS Forum](https://forums.ufscommunity.org/) +by the Developmental Testbed Center (DTC). -The UPP uses some of the [NCEPLIBS](https://github.com/NOAA-EMC/NCEPLIBS) -project. +## Documentation +User Guide for latest public release: https://upp.readthedocs.io/en/latest/. +Technical code-level documentation: https://noaa-emc.github.io/UPP/. + +## Developer Information +Please see review the [wiki](https://github.com/NOAA-EMC/UPP/wiki) ## Authors @@ -57,7 +61,8 @@ Code Manager: Wen Meng, Huiya Chuang, Kate Fossell ## Prerequisites -This package requires the following NCEPLIBS packages: +The UPP requires certain NCEPLIB packages to be installed via +the HPC-Stack project. - [NCEPLIBS-g2](https://github.com/NOAA-EMC/NCEPLIBS-g2) - [NCEPLIBS-g2tmpl](https://github.com/NOAA-EMC/NCEPLIBS-g2tmpl) @@ -92,29 +97,18 @@ The following third-party libraries are required: Builds include: -- Operational use GNC build as Wen described for both library and - executable (library used for GFS only at this time) - -- MRW App uses UPP packaged with nceplibs and cmake to build/run with - executable (via release/public-v1 branch). - -- SRW App uses UPP repo branch/tag directly and uses cmake to - build/run with executable (via release/public-v2 branch). - -- Community standalone uses UPP repo branch/tag directly and uses - cmake to build/run with executable (via release/public-v2 - branch). For these procedures, we add a - -DCMAKE_PREFIX_PATH=${INSTALL_PREFIX} where INSTALL_PREFIX is the - location of the nceplibs installation as a dependency requirement. - -``` -mkdir build -cd build -cmake .. -DCMAKE_INSTALL_PREFIX=/path/to/install -(or cmake .. -DCMAKE_INSTALL_PREFIX=/path/to/install -DEMC_EXEC_DIR=ON) -make -j 4 -make install -``` +- Inline post (UPP library): Currently only supported for the GFS + and MRW Application. + +- Offline post (UPP executable): Supported for Regional applications + including SRW, RRFS, HAFS, and standalone applications of UPP. + + +CMake is used to manage all builds of the UPP. +The script `UPP/tests/compile_upp.sh` can be used to automatically +build UPP on fully supported platforms where HPC-stack is supported. +Details in this script can be used to build on new platforms. + ## Disclaimer From 856bdccead80a77c225f76f11608046b9c3f4ef5 Mon Sep 17 00:00:00 2001 From: Kate Fossell Date: Mon, 25 Apr 2022 16:25:13 -0500 Subject: [PATCH 4/6] Formatting updates --- README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index c7c3801b2..64516acd8 100644 --- a/README.md +++ b/README.md @@ -48,6 +48,7 @@ by the Developmental Testbed Center (DTC). ## Documentation User Guide for latest public release: https://upp.readthedocs.io/en/latest/. + Technical code-level documentation: https://noaa-emc.github.io/UPP/. ## Developer Information @@ -57,7 +58,7 @@ Please see review the [wiki](https://github.com/NOAA-EMC/UPP/wiki) NCEP/EMC Developers -Code Manager: Wen Meng, Huiya Chuang, Kate Fossell +Code Managers: Wen Meng, Huiya Chuang, Kate Fossell ## Prerequisites @@ -76,9 +77,9 @@ the HPC-Stack project. Also required to build NCEPpost executable (cmake option BUILD_POSTEXEC): -- [NCEPLIBS-sigio](https://github.com/NOAA-EMC/NCEPLIBS-sigio) - -- [NCEPLIBS-sfcio](https://github.com/NOAA-EMC/NCEPLIBS-sfcio) - -- [NCEPLIBS-nemsio](https://github.com/NOAA-EMC/NCEPLIBS-nemsio) - +- [NCEPLIBS-sigio](https://github.com/NOAA-EMC/NCEPLIBS-sigio) +- [NCEPLIBS-sfcio](https://github.com/NOAA-EMC/NCEPLIBS-sfcio) +- [NCEPLIBS-nemsio](https://github.com/NOAA-EMC/NCEPLIBS-nemsio) - [NCEPLIBS-gfsio](https://github.com/NOAA-EMC/NCEPLIBS-gfsio) The [NCEPLIBS-wrf_io](https://github.com/NOAA-EMC/NCEPLIBS-wrf_io) From 318a0d95a0963a165a89c8aac61207295148e3ce Mon Sep 17 00:00:00 2001 From: Kate Fossell Date: Tue, 26 Apr 2022 08:14:02 -0500 Subject: [PATCH 5/6] update inline post supported applications --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 64516acd8..c6cf468c0 100644 --- a/README.md +++ b/README.md @@ -98,8 +98,8 @@ The following third-party libraries are required: Builds include: -- Inline post (UPP library): Currently only supported for the GFS - and MRW Application. +- Inline post (UPP library): Currently only supported for the GFS, RRFS, + HAFS, and the UFS-MRW Application. - Offline post (UPP executable): Supported for Regional applications including SRW, RRFS, HAFS, and standalone applications of UPP. From 0c585810cd0e679d6e24b98e2e9803869bbb1cdd Mon Sep 17 00:00:00 2001 From: Kate Fossell Date: Tue, 26 Apr 2022 09:17:55 -0500 Subject: [PATCH 6/6] Additional updates to supported models --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index c6cf468c0..1592d58d4 100644 --- a/README.md +++ b/README.md @@ -8,9 +8,11 @@ output. The UPP is currently used in operations with the Global Forecast System (GFS), GFS Ensemble Forecast System (GEFS), North American Mesoscale (NAM), Rapid Refresh (RAP), High Resolution Rapid Refresh -(HRRR), Short Range Ensemble Forecast (SREF), Hurricane WRF (HWRF) -applications, and is also used in Unified Forecasting System (UFS) -applications (MRW, SRW, and HAFS). +(HRRR), Short Range Ensemble Forecast (SREF), and Hurricane WRF (HWRF) +applications. It is also used in the Unified Forecasting System (UFS), +including the Rapid Refresh Forecast System (RRFS), Hurricane Application +Forecasting System (HAFS), and the Medium Range Weather (MRW) and Short +Range Weather (SRW) Applications. The UPP provides the capability to compute a variety of diagnostic fields and interpolate to pressure levels or other vertical