Parfait is an unstructured mesh toolkit developed at NASA Langley.

Quick Start if you just want the Distance Calculator Utility

cd parfait
mkdir build
cd build
cmake .. -DUTILS_ONLY=TRUE -DCMAKE_INSTALL_PREFIX=/path/to/your/desired/install/path
make -j install

There should now be a DistanceCalculator binary utility in your /path/to/your/desired/install/path/parfait/bin

Building

The Parfait toolkit is header only. If you just want to use the C++ toolkit simply

mkdir build
cd build
cmake .. -DHEADER_ONLY=TRUE
make -j install

Dependencies

Parfait depends on C++14. We suggest you use the latest GNU compiler. We regularly test with GCC 6.2 and 7.0. The CMake build system used in Parfait is under development. Defining dependencies is not uniform. Sorry for the mess.

MPI

All Parfait utilities currectly rely on MPI. Please make sure MPI is added to your LD_LIBRARY_PATH and INCLUDE_PATH (on many linux systems you simply module load ... your favorite flavor of MPI).

Metis and ParMetis

Please make sure a compatible version of Metis and Parmetis is added to your LD_LIBRARY_PATH and INCLUDE_PATH (on many linux systems you simply module load ...).

nlohmann_json

If not strictly installing header files Parfait requires nlohmann_json (https://github.com/nlohmann/json). You can install nlohmann::json using their provided cmake based build system, and add the Findnlohmann_json.cmake path to your CMAKE_PREFIX_PATH environment variable. Or you can install their single header in an nlohmann folder somewhere on your machine, and build with:

mkdir build
cd build
cmake .. -Dnlohmann_json_path=/path/to/nlohmann -DBUILD_TESTS=FALSE
make -j install

Note: Your path must point to the folder containing the nlohmann folder. Do not point to json.hpp.

VTK

Some Parfait utilities require the VTK libraries to be installed, and for the FindVTK.cmake file to be discoverable by cmake.

Catch2

To enable building Parfait's unit tests you must have Catch2 installed. You can install Catch2 using their provided cmake and add the FindCatch2.cmake path to your CMAKE_PREFIX_PATH environment variable. Or, you can simple install the Catch2 catch.hpp header file, and build with:

mkdir build
cd build
cmake .. -DCatch2_path=/path/to/catch.hpp
make -j install