Skip to content

Latest commit

 

History

History
126 lines (96 loc) · 4.37 KB

README.md

File metadata and controls

126 lines (96 loc) · 4.37 KB

UFS_UTILS

Utilities for the NCEP models. This is part of the NCEPLIBS project.

Documentation for the chgres_cube utility can be found at https://noaa-emcufs-utils.readthedocs.io/en/latest/.

Complete documentation can be found at https://noaa-emc.github.io/UFS_UTILS/.

Authors

Utility Programmer(s)
chgres_cube George Gayno, Jeff Beck, Larissa Reames
emcsfc_ice_blend George Gayno
emcsfc_snow2mdl George Gayno
fvcom_tools David Wright, University of Michigan, Ming Hu, GSD/AMB
global_cycle George Gayno, Shrinivas Moorthi, Mark Iredell, Xu Li, Hang Lei
grid_tools R. J. Purser (regional_esg_grid), Tom Black/Ben Blake (shave.fd), Gerard Ketefian (global_equiv_resol), Tsukasa Fujita, JMA (pmat2), GFDL programmer (topo filtering code).
orog_mask_tools Ning Wang, Jordan Alpert, Shan Sun and Ning Wang
sfc_climo_gen George Gayno
vcoord_gen Fanglin Yang, Mark Iredell

UFS_UTILS Code managers: George Gayno, Kyle Gerheiser

Prerequisites

This package requires the following NCEPLIBS packages:

This package also requires:

Installing

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/path/to/install ..
make -j2
make install

Contents

The UFS_UTILS package contains the following utilities (under the sorc directory):

  • chgres_cube
  • emcsfc_ice_blend
  • emcsfc_snow2mdl
  • fre-nctools
  • fvcom_tools
  • global_cycle
  • grid_tools
  • orog_mask_tools
  • sfc_climo_gen
  • vcoord_gen

The reg_tests directory contains the consistency test code.

The fix directory is where we set links to directories containing large, static data files used by UFS_UTILS programs.

The tests directory contains unit tests.

The ush directory contains scripts to run UFS_UTILS programs. Most are called from driver scripts.

The util directory contains utility scripts to create coldstart initial conditions for GFS parallels, and to run the vertical coordinate generator.

The parm directory contains variable mapping parameter tables used by the chgres_cube program.

The driver_scripts directory contains high-level driver scripts to create a model grid on officially supported HPC platforms.

The modulefiles directory contains modules loaded when building UFS_UTILS on supported HPC platforms. They are also loaded at runtime by utility and consistency test scripts.

The docs directory contains the control file for the doxygen documentation build, as well as some markdown files which are part of the documentation. It also contains (in the source subdirectory) the ReadTheDocs documentation files.

References

Gayno G., Beck J., Carson L., Pre-Processing: chgres_cube, UFS MRW App Training, 5 November 2020.

Disclaimer

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.