Go to file
Axel Kohlmeyer b68e56e9be
(partially) apply clang-format
2022-11-30 19:11:20 -05:00
.github Merge pull request #3541 from stanmoore1/kk_reax_tag 2022-11-29 14:56:00 -05:00
bench remove references to non-existing folders 2022-03-31 17:49:24 -04:00
cmake add ML-POD package to relevant CMake presets 2022-11-27 17:16:13 -05:00
doc Merge branch 'develop' into pod-updates 2022-11-30 13:47:40 -05:00
examples Merge branch 'develop' into pod-updates 2022-11-30 13:25:32 -05:00
fortran Merge branch 'develop' into fortran-expansion 2022-10-31 17:57:33 -04:00
lib Merge branch 'develop' into pod-updates 2022-11-30 13:47:40 -05:00
potentials add metadata tags to potential file for mlpod 2022-11-28 15:05:20 -05:00
python add comment that this file needs to be updated when APIs are added 2022-10-28 21:13:50 -04:00
src (partially) apply clang-format 2022-11-30 19:11:20 -05:00
tools document removal of "box" command. 2022-11-21 17:59:29 -05:00
unittest Merge branch 'develop' into pod-updates 2022-11-30 13:47:40 -05:00
.gitattributes Add citation information to GitHub 2022-07-26 19:52:01 -06:00
.gitignore ignore wheel files 2022-02-27 07:03:02 -05:00
.lgtm.yml expand LGTM exposure of LAMMPS styles 2021-05-31 18:23:37 -04:00
CITATION.cff add a few more keywords 2022-07-27 05:36:05 -04:00
LICENSE indicate that we use GPLv2 2021-03-05 14:16:40 -05:00
README expand homepage checker tool to check a few more folders and apply updates 2022-10-24 10:58:39 -04:00
SECURITY.md update explanations for version updates in security policy file 2022-09-25 10:43:59 -04:00

README

This is the LAMMPS software package.

LAMMPS stands for Large-scale Atomic/Molecular Massively Parallel
Simulator.

Copyright (2003) 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.

----------------------------------------------------------------------

LAMMPS is a classical molecular dynamics simulation code designed to
run efficiently on parallel computers.  It was developed at Sandia
National Laboratories, a US Department of Energy facility, with
funding from the DOE.  It is an open-source code, distributed freely
under the terms of the GNU Public License (GPL) version 2.

The code is maintained by the LAMMPS development team who can be emailed
at developers@lammps.org.  The LAMMPS WWW Site at www.lammps.org has
more information about the code and its uses.

The LAMMPS distribution includes the following files and directories:

README                     this file
LICENSE                    the GNU General Public License (GPL)
bench                      benchmark problems
cmake                      CMake build files
doc                        documentation
examples                   simple test problems
fortran                    Fortran wrapper for LAMMPS
lib                        additional provided or external libraries
potentials                 interatomic potential files
python                     Python wrappers for LAMMPS
src                        source files
tools                      pre- and post-processing tools

Point your browser at any of these files to get started:

https://docs.lammps.org/Manual.html         LAMMPS manual
https://docs.lammps.org/Intro.html          hi-level introduction
https://docs.lammps.org/Build.html          how to build LAMMPS
https://docs.lammps.org/Run_head.html       how to run LAMMPS
https://docs.lammps.org/Commands_all.html   Table of available commands
https://docs.lammps.org/Library.html        LAMMPS library interfaces
https://docs.lammps.org/Modify.html         how to modify and extend LAMMPS
https://docs.lammps.org/Developer.html      LAMMPS developer info

You can also create these doc pages locally:

% cd doc
% make html                # creates HTML pages in doc/html
% make pdf                 # creates Manual.pdf