Overview

The GRVY Toolkit is a library used to house various support functions often required for application development of high-performance, scientific applications. The library is written in C++, but provides an API for development in C and Fortran. The primary functionality provided by the library is categorized as follows:

a flexible method for parsing keyword driven input files (with backwards-compatibility support)
a performance timing mechanism to provide a simple summary of individual code section performance along with basic statistics
an HDF5 based historical performance mechanism for logging application performance over time on various compute resources
a simple priority-based logging mechanism to control application messages
utilities for offloading out-of-core read/write operations to a pool of distributed shared-memory nodes using MPI for data transfer
miscellaneous file handling and math utilities

To aid in usage, this document is further divided into the following subsections:

Reporting Bugs

Bugs in the code and errors or omissions in the documentation can be reported on GitHub. Requests and contributions are welcome as well. All bug reports should include:

the version number of the GRVY library (versioning information can be obtained by running the grvy_version binary located in the bin/ directory of a local libGRVY installation),
the hardware and operating system,
the local compiler version number,
a description of the bug behavior, and ideally,
a short program which reproduces the bug.

This library is free software; you can redistribute it and/or modify it under the terms of the Version 2.1 GNU Lesser General Public License as published by the Free Software Foundation.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

Acknowledgments

This material is based in part upon work supported by the Department of Energy National Nuclear Security Administration under Award Numbers DE-FC52-08NA28615 and DE-NA0003969.