cMHN - C++ library for learning MHNs with pRC

cMHN is a C++ library developed to make efficient calculations of Mutual Hazard Networks (MHNs) possible using only a few lines of code. Built on top of pRC, a library for handling high-dimensional tensors in the tensor train format, cMHN is highly performant, while still being easy to write.

For functionality of a certain feature of cMHN, check the respective function's or class' documentation. Some explanations and tutorials will be made available here when time allows.

Quick Start

The file example.cpp provides C++ code to learn a theta matrix from a test dataset with 4 events, both in the nonTT as well as the TT version. To compile it, just run

make SOURCE=example.cpp TARGET=example.out EVENTS=4 MAXRANKP=8 MAXRANKQ=8

If only the nonTT or TT variant is needed, compilation is quicker if this is specified as follows:

make (non)tt SOURCE=example.cpp TARGET=example.out EVENTS=4 MAXRANKP=8 MAXRANKQ=8

It is particularly important to specify this when compiling for >20 events, as the compilation time of the nontt version grows exponentially.

Documentation

The documentation is available here.

Version

This is version 1.2 of cMHN, released on 20.06.24.