4. Building Stand-Alone

4.1. Software Requirements

Before installing the UPP code, it is necessary to ensure that you have the required libraries available on your system. These libraries include:

An introduction of each can be found in their respective top level README.md files. Detailed instructions for building the libraries on various platforms can be found in the NCEPLIBS-external/doc directory.

Certain machines do have the NCEP libraries in a pre-installed location for use to build UPP. Paths to these pre-installed libraries are available on the UFS-SRW wiki and include platform name and compiler version.

4.2. Obtaining and Installing UPP

Building and running UPP V9.0.0 has been tested on the following platforms using pre-configured libraries.

System

Compiler and Version

NCAR Cheyenne

Intel 19.1.1

GNU 9.1.0 GNU 10.1.0

NOAA Hera

Intel 18.0.5.274

Move to the directory where you want to clone and build UPP and clone the repository into the directory UPP.

git clone -b branch-or-tag-name https://github.com/NOAA-EMC/UPP

where, branch-or-tag-name is the release branch or tag you wish to clone.

Move into the top level UPP directory and create and move into the build directory. Then build the UPP code using the cmake utility. The path INSTALL_PREFIX should point to the location of the pre-installed NCEP libraries.

cd UPP
mkdir build && cd build

cmake .. -DCMAKE_INSTALL_PREFIX=.. -DCMAKE_PREFIX_PATH=${INSTALL_PREFIX}
make install

Note

To build in debug mode, you can add -DCMAKE_BUILD_TYPE=Debug to the cmake command. This removes compiler optimization flags and adds -g to the fortran compilation. You can also use -DCMAKE_BUILD_TYPE=RELWITHDEBINFO, which gives the -g, but keeps the -O2 optimization for the fortran compilation.

Move back to the top level UPP directory and create a directory for the CRTM fix files to be unpacked in. Download the fix files from the Github release page or use the wget command. Unpack the tar file.

cd ../
mkdir crtm && cd crtm
wget https://github.com/NOAA-EMC/UPP/releases/download/upp_v9.0.0/fix.tar.gz
tar -xzf fix.tar.gz

Note

To make a clean build, simply remove both the /build directory and the bin/upp.x executable and then re-create the build from step #2. This is recommended if a mistake is made during the installation process. If a simple change is made to the code, you can simply type make install again in the pre-existing build directory.

4.3. UPP Directory Structure

Under the main directory UPP reside the following relevant subdirectories (The * indicates a directory that exists only after the build is complete):

bin*: Contains the upp.x executable after successful compilation
build: Contains the UPP build
include*: Contains include modules built/used during compilation of UPP
lib*: Libraries built/used by UPP that are separate from NCEPlibs
parm: Contains parameter files, which can be modified by the user to control how the post processing is performed.
scripts: Contains a sample run script to process fv3 history files.
- run_upp: runs upp.x.
sorc: Contains source codes for:
- ncep_post.fd: Source code for the UPP