Skip to content

Building and Running the UPP

Gillian Petro edited this page Sep 9, 2024 · 6 revisions

Building the UPP

UPP users can check out the develop branch or any release branch and build the UPP executable on WCOSS2 and other supported systems (e.g., Hera, Orion) by running:

> git clone -b name-of-branch https://github.com/NOAA-EMC/UPP.git
> cd tests
> ./compile_upp.sh

Users should replace name-of-branch in the clone command with the name of an actual branch or tag (e.g., develop, upp_v11.0.0). The executable upp.x will appear under exec/ if the build was successful.

Additional details can be found in the User's Guide.


How to Run the UPP

A step-by-step guide to running standalone UPP (not part of an application) can be found in the UPP User's Guide. When running the UPP as part of an application (e.g., UFS SRW or MRW Apps, operational workflows, etc.), please refer to application documentation for running the UPP as part of that system.

itag templates

Below are a few examples of itags used for running different applications. Please see the UPP User's Guide for more information about itags.

  • itag for processing RRFS
&model_inputs
fileName='/u/Wen.Meng/noscrubd/ncep_post/post_regression_test_new/data_in/dynf006.nc'
IOFORM='netcdf'
grib='grib2'
DateStr='2019-06-20_06:00:00'
MODELNAME='FV3R'
fileNameFlux='/u/Wen.Meng/noscrubd/ncep_post/post_regression_test_new/data_in/phyf006.nc'
/
&NAMPGB
KPO=47,PO=1000.,975.,950.,925.,900.,875.,850.,825.,800.,775.,750.,725.,700.,675.,650.,625.,600.,575.,550.,525.,500.,475.,450.,425.,400.,375.,350.,325.,300.,275.,250.,225.,200.,175.,150.,125.,100.,70.,50.,30.,20.,10.,7.,5.,3.,2.,1.,
/
  • itag for processing HAFS
&model_inputs
fileName='/u/Wen.Meng/noscrubd/ncep_post/post_regression_test_new/data_in/dynf009.nc'
IOFORM='netcdf'
grib='grib2'
DateStr='2020-08-25_21:00:00'
MODELNAME='FV3R'
fileNameFlux='/u/Wen.Meng/noscrubd/ncep_post/post_regression_test_new/data_in/phyf009.nc'
/
&NAMPGB
KPO=47,PO=1000.,975.,950.,925.,900.,875.,850.,825.,800.,775.,750.,725.,700.,675.,650.,625.,600.,575.,550.,525.,500.,475.,450.,425.,400.,375.,350.,325.,300.,275.,250.,225.,200.,175.,150.,125.,100.,70.,50.,30.,20.,10.,7.,5.,3.,2.,1.,
/
  • itag for processing 3DRTMA
&model_inputs
fileName='/u/Wen.Meng/noscrubd/ncep_post/post_regression_test_new/data_in/3drtma/rtma3d.t0000z.wrf_inout.nc'
IOFORM='netcdf'
grib='grib2'
DateStr='2020-11-30_00:00:00'
MODELNAME='RAPR'
SUBMODELNAME='RTMA'
/
&NAMPGB
KPO=47,PO=2.,5.,7.,10.,20.,30.,50.,70.,75.,100.,125.,150.,175.,200.,225.,250.,275.,300.,325.,350.,375.,400.,425.,450.,475.,500.,525.,550.,575.,600.,625.,650.,675.,700.,725.,750.,775.,800.,825.,850.,875.,900.,925.,950.,975.,1000.,1013.2
/
  • itag for processing GFS/GEFS
&model_inputs
fileName='nemsfile'
IOFORM='netcdfpara'
grib='grib2'
DateStr='2021-02-16_06:00:00'
MODELNAME='GFS'
fileNameFlux='flxfile'
/
&NAMPGB
KPO=57,PO=1000.,975.,950.,925.,900.,875.,850.,825.,800.,775.,750.,725.,700.,675.,650.,625.,600.,575.,550.,525.,500.,475.,450.,425.,400.,375.,350.,325.,300.,275.,250.,225.,200.,175.,150.,125.,100.,70.,50.,40.,30.,20.,15.,10.,7.,5.,3.,2.,1.,0.7,0.4,0.2,0.1,0.07,0.04,0.02,0.01,
/