flare-pp 0.1.0

Many-body extension of the flare code

flare++

Major features:

• Bayesian force fields based on sparse Gaussian process regression.
• Multielement many-body descriptors based on the atomic cluster expansion.
• Mapping to efficient parametric models.
• Coupling to LAMMPS for large-scale molecular dynamics simulations.

Check out our preprint introducing flare++ here.

Demo and Instructions for Use

An introductory tutorial in Google Colab is available here. The tutorial shows how to run flare++ on energy and force data, demoing "offline" training on the MD17 dataset and "online" on-the-fly training of a simple aluminum force field. A video walkthrough of the tutorial, including detailed discussion of expected outputs, is available here.

The tutorial takes a few minutes to run on a normal desktop computer or laptop (excluding installation time).

Installation guide

The easiest way to install is with pip:

pip install flare_pp

This will take a few minutes on a normal desktop computer or laptop.

If you're installing on Harvard's compute cluster, make sure to load the following modules first:

module load cmake/3.17.3-fasrc01 python/3.6.3-fasrc01 gcc/9.3.0-fasrc01

Compiling LAMMPS

See lammps_plugins/README.md.

System requirements

Software dependencies

• cmake>=3.14.5 (to compile the C++ source code)
• flare (for on-the-fly training)

Operating systems

flare++ is tested with Github Actions on a Linux operating system (Ubuntu 20.04.3). You can find a summary of recent builds here.

We expect flare++ to be compatible with Mac and Windows operating systems, but can't guarantee this. If you run into issues running the code on Mac or Windows, please post to the issue board.

Hardware requirements

There are no non-standard hardware requirements to download the software and train simple models—the introductory tutorial can be run on a single cpu. To train large models (10k+ sparse environments), we recommend using a compute node with at least 100GB of RAM.

Documentation

Preliminary documentation of the C++ source code can be accessed here.