This is a C library implementing a variety of jet marching methods (JMMs) for solving the eikonal equation in two and three dimensions.

This library can be built using Meson.

To build, run the following:

git clone https://github.com/sampotter/jmm
cd jmm
meson configure --warnlevel=3 --werror --buildtype=release builddir
cd builddir
meson compile

The library currently depends on a fork of TetGen, which we maintain. This dependency will be picked up and built automatically by Meson.

Until this library is officially released, there is no official documentation. Instead, we recommend either taking a look at the examples, or submitting an issue. Eventually, we will release tutorial-style documentation which gives an overview of the library, discusses some of the main entrypoints, and provides a roadmap.

In the meantime, individual functions in the library are documented, with the documentation comments preceding function definitions (i.e., the implementations are documented in the .c files). If you use something like LSP Mode, it should be possible to look this documentation up on the fly. For this reason, it is unlikely that Doxygen-style documentation will be provided for this library.

The ./examples directory contains some examples of short programs which use this library to do different things. Each example contains its own README.md file explaining how to compile and run it. These examples can be used to quickly learn how to get going with this library.

Main development takes place in the develop branch.

Some important versions are tagged (you can find these under the "branches" menu if you're browsing this repository using GitHub). Currently, there are the following branches: