/FitSNAP

Software for generating SNAP machine-learning interatomic potentials

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

FitSNAP3

A Python Package For Training SNAP Interatomic Potentials for use in the LAMMPS molecular dynamics package

Copyright (2016) Sandia Corporation. Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software. This software is distributed under the GNU General Public License

Original author:

Aidan P. Thompson, athomps (at) sandia (dot) gov (Sandia National Labs)
http://www.cs.sandia.gov/~athomps

Key contributors (alphabetical):

Mary Alice Cusentino (Sandia National Labs)
Nicholas Lubbers (Los Alamos National Lab)
Charles Sievers (UC Davis, Sandia National Labs)
Adam Stephens (Sandia National Labs)
Mitchell Wood (Sandia National Labs)

Additional authors (alphabetical):

Elizabeth Decolvenaere (D. E. Shaw Research)
Stan Moore (Sandia National Labs)
Steve Plimpton (Sandia National Labs)
Gary Saavedra (Sandia National Labs)
Peter Schultz (Sandia National Labs)
Laura Swiler (Sandia National Labs)

Using this package:

  • [Required] This package expects a python 3.6+ version.
  • [Required] Compile LAMMPS (lammps.sandia.gov) as a shared library, detailed instructions can be found here docs/LAMMPS.md. If you can open python and run import lammps; lmp = lammps.lammps() and it succeeds, you should be good.

Installing:

  • For the most recent bug fixes/code changes:

    • Clone this repository and add it to your PYTHONPATH environment variable. Periodically git pull for code updates.

  • For stable, self-contained copy of this code:

    • Set up a Conda environment, then pip install fitsnap3. Less complications using mpi4py this way.

  • See docs/INSTALL.md for more information.

  • We recommend always using an up-to-date LAMMPS version as this is the preferred decriptor calculator.

Running:

  • (mpirun -np #) python -m fitsnap3 [options] infile (optional)
  • Command line options can be seen with python -m fitsnap3 -h
  • Input files are described by docs/TEMPLATE.in and docs/GROUPLIST.template
  • Examples of published SNAP interatomic potentials can be found in examples/