This is a collection of libraries commonly known as NCEPLIBS that are required for several NCEP applications e.g. UFS, GSI, UPP, etc. For general information about NCEPLIBS, the user is referred to the Wiki.
NCEPLIBS comprises of the following libraries:
| NCEP library | Version |
|---|---|
| NCEPLIBS-bacio | 2.4.1 |
| NCEPLIBS-bufr | 11.4.0 |
| EMC-crtm | 2.3.0 |
| NCEPLIBS-g2 | 3.4.1 |
| NCEPLIBS-g2tmpl | 1.9.1 |
| NCEPLIBS-gfsio | 1.4.1 |
| NCEPLIBS-ip | 3.3.3 |
| NCEPLIBS-landsfcutil | 2.4.1 |
| NCEPLIBS-nemsio | 2.5.2 |
| NCEPLIBS-nemsiogfs | 2.5.3 |
| EMC_post | dceca26 |
| NCEPLIBS-sfcio | 1.4.1 |
| NCEPLIBS-sigio | 2.3.2 |
| NCEPLIBS-sp | 2.3.3 |
| NCEPLIBS-w3emc | 2.7.3 |
| NCEPLIBS-w3nco | 2.4.1 |
| NCEPLIBS-wrf_io | 1.1.1 |
| NCEPLIBS-ip2 | 1.1.2 |
| NCEPLIBS-wgrib2 | 2.0.8 |
A supported C/C++ and Fortran compiler (see table below). Other versions may work, in particular if close to the versions listed below.
| Compiler vendor | Supported (tested) versions |
|---|---|
| Intel | 18.0.3.222, 18.0.5.274, 19.0.2.187, 19.0.5.281, 19.1.0.166 |
| GNU | 8.3.0, 9.X.0 |
A supported MPI library (see table below). Other versions may work, in particular if close to the versions listed below.
| MPI library | Supported (tested) versions |
|---|---|
| MPICH | 3.3.1, 3.3.2 |
| MVAPICH2 | 2.3.3 |
| Open MPI | 3.1.5, 4.0.2 |
| Intel MPI | 2018.0.4, 2019.6.154, 2020.0.166 |
| SGI MPT | 2.19 |
A software stack consisting of the following third-party libraries (TPL), compiled with the same compiler and MPI library (where applicable). Other versions may work, in particular if close to the versions listed below.
| Library | Supported (tested) versions |
|---|---|
| CMake | cmake-3.16.3 |
| zlib | zlib-1.2.11 |
| libpng | libpng-1.6.35 |
| libjpeg | jpeg-9.1 |
| Jasper | jasper-2.0.16 |
| HDF5 | hdf5-1.10.4 |
| NetCDF | netcdf-c-4.7.3, netcdf-fortran-4.5.2 |
The NCEPLIBS-external project provides an convenient way to install the required TPL on supported platforms such as generic Linux/macOS systems.
Clone the repository:
git clone https://github.com/NOAA-EMC/NCEPLIBS
CMake employs an out-of-source build. Create a directory for configuring the build and cd into it:
mkdir -p build && cd build
Set the compilers, if needed, to match those being used for compiling the TPL listed above: FC, CC, and CXX environment variables can be used to point to the desired Fortran, C, and C++ compilers.
Execute cmake from inside your build directory.
cmake -DCMAKE_INSTALL_PREFIX=<nceplibs-prefix> ../NCEPLIBS
If the TPL are not located in a path recognized by cmake e.g. /usr/local, it may be necessary to provide the appropriate environment variables e.g. <package_ROOT> or CMAKE_PREFIX_PATH so that cmake is able to locate these dependencies.
The installation prefix for NCEPLIBS is provided by the cmake command-line argument -DCMAKE_INSTALL_PREFIX=<nceplibs-prefix>
To build and install:
make -j<x>
This will build and install all the NCEPLIBS and place them into the installation prefix <nceplibs-prefix>.
Additional cmake command-line options while configuring NCEPLIBS:
-DFLAT=ON|OFF - determines the installation tree heirarchy
-DDEPLOY=ON|OFF - prepares and deploys Lua modulefiles for each of the NCEPLIBS libraries. To deploy modulefiles:
make deploy
LMod Environment module system is required to load/unload these modules.
Some HPC systems use Tcl based Environment modules. NCEPLIBS provides a means to deploy Tcl module files and can be exercised as follows:
-DTCLMOD=ON - enables option to change Lua modulefiles to Tcl modulefiles for each of the NCEPLIBS libraries. To make the change:
make tcl
On machines that do not provide access to Github, a DOWNLOAD_ONLY and USE_LOCAL option is provided. To download the NCEPLIBS without building them use the cmake command line option -DDOWNLOAD_ONLY=ON. This will download all the NCEPLIBS in a local download folder. make tarball will tar and zip this folder into nceplibs.tgz which can then be transferred to the machine without GitHub access. Untar the tarball, and use the cmake command line option USE_LOCAL as -DUSE_LOCAL=ON. This will use the source code from the download directory.
NCEPLIBS can be used in any application that uses cmake to configure and build by adding -DCMAKE_PREFIX_PATH=<nceplibs-prefix> to the cmake command line during configuration.
The United States Department of Commerce (DOC) GitHub project code is provided on an "as is" basis and the user assumes responsibility for its use. DOC has relinquished control of the information and no longer has responsibility to protect the integrity, confidentiality, or availability of the information. Any claims against the Department of Commerce stemming from the use of its GitHub project will be governed by all applicable Federal law. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by the Department of Commerce. The Department of Commerce seal and logo, or the seal and logo of a DOC bureau, shall not be used in any manner to imply endorsement of any commercial product or activity by DOC or the United States Government.