Skip to main content

A SEAMM plug-in for LAMMPS, a forcefield-based molecular dynamics code.

Project description

GitHub pull requests Build Status Code Coverage Code Quality Documentation Status Updates for Dependencies PyPi VERSION

SEAMM LAMMPS Plug-in

A SEAMM plug-in for LAMMPS, a forcefield-based molecular dynamics code.

This plug-in provides a graphical user interface (GUI) for setting up complex simulations using LAMMPS. It uses a sub-flowchart that provides steps such as constant pressure and temperature (NPT) dynamics which give access to the functionality in LAMMPS in a more consistent and understandable way than the inscrutable fixes that LAMMPS uses.

These sub-flowcharts mirror the main flowchart in form and function and can use the same variables such as temperature and pressure that are accessible anywhere in the flowcharts. This allows “programming” a LAMMPS workflow in the same familiar way that SEAMM uses to represent the overall workflow.

Features

  • Use of any forcefield supported by the forcefield plug-in:

    • PCFF

    • OpenKIM: EAM, MEAM, LJ, ReaxFF

  • Molecular statics: minimization

  • Molecular dynamics: NVE, NVT, and NPT with any of the approaches supported in LAMMPS

  • Automatic statistical analysis of averages from MD

    • Detection of equilibration

    • Mean and standard error of the mean for the sampling after equilibration

    • Autocorrelation function and time

    • Statistical inefficiency

    • Plotting of results in the Dashboard

  • Using property values to drive MD. Rather than running MD for a length of time, automatically run long enough to determine a set of properties within given error bars.

Acknowledgements

This package was created with Cookiecutter and the molssi-seamm/cookiecutter-seamm-plugin project template.

Developed by the Molecular Sciences Software Institute (MolSSI), which receives funding from the National Science Foundation under award ACI-1547580

History

2021.2.11 (11 February 2021)

  • Updated the README file to give a better description.

  • Updated the short description in setup.py to work with the new installer.

  • Added keywords for better searchability.

2021.2.4.1 (4 February 2021)

  • Internal patch to fix CI; no changes for users.

2021.2.4 (4 February 2021)

  • Updated for compatibility with the new system classes in MolSystem 2021.2.2 release.

2020.12.4 (4 December 2020)

  • Internal: switching CI from TravisCI to GitHub Actions, and in the process moving documentation from ReadTheDocs to GitHub Pages where it is consolidated with the main SEAMM documentation.

2020.11.2 (2 November 2020)

  • Updated to be compatible with the new command-line argument handling.

2020.10.13 (13 October 2020)

  • Added capability to run MD until a set of user-selected properties are converged to requested accuracy.

2020.9.25 (25 September 2020)

  • Updated to be compatible with the new system classes in MolSystem.

2020.8.2.1 (2 August 2020)

  • Bugfix: Fixed problem with nonbonds and charges just introduced.

2020.8.2 (2 August 2020)

  • Bugfix: Corrected the time units when using metal units with e.g. EAM potentials.

2020.8.1 (1 August 2020)

  • Added support for OpenKIM potentials.

0.9.4 (29 May 2020)

  • Cleaned up the output for the statistical analysis.

0.9.3 (29 May 2020)

  • Fixed issue with settings for bins in LAMMPS for small nonperiodic systems with just a few atoms.

0.9.2 (25 May 2020)

  • Switched to using PYMBAR for detecting covergence to equilibrium for MD runs. This is a more robust solution than the previous approach.

0.9.1 (24 May 2020)

  • Support for rigid water models, such as TIP-3P.

0.9 (15 April 2020)

  • Support for plots in the dashboard of properties from MD.

  • Added option to produce local HTML for the above plots.

0.8.2 (2020-01-25)

  • No significant changes in functionality.

  • Incorporating changes to the SEAMM infrastructure, which simplify the code for plug-ins.

  • Updating the Travis CI to handle incompatible changes in Travis, and to use Conda environments in all steps.

0.7.1 (18 December 2019)

  • Fixed problem with assigning charges to the system.

0.7.0 (17 December 2019)

  • General clean-up of code and output.

0.6 (8 September 2019)

  • Switched to ConfigArgParse for handling command-line arguments.

  • Added the locations of LAMMPS executables to a configuration file for easier access.

0.5.2 (31 August 2019)

  • Defined the correct requirements for installation.

0.5.1 (30 August 2019)

  • Bugfix: corrected the name of the LAMMPS executable.

0.5.0 (30 August 2019)

  • Added ability to use serial or parallel versions of LAMMPS based on an environment variable.

0.3.1 (27 August 2019)

  • Added initial, fairly reasonable output.

0.2.1 (29 July 2019)

  • First release on PyPI.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lammps_step-2021.7.29.tar.gz (93.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lammps_step-2021.7.29-py2.py3-none-any.whl (81.7 kB view details)

Uploaded Python 2Python 3

File details

Details for the file lammps_step-2021.7.29.tar.gz.

File metadata

  • Download URL: lammps_step-2021.7.29.tar.gz
  • Upload date:
  • Size: 93.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.6

File hashes

Hashes for lammps_step-2021.7.29.tar.gz
Algorithm Hash digest
SHA256 72c473451eefcbf7f43f3d2cbc9202246d44b30da3b2ccd60801fa57a858fa30
MD5 92cb8e0b5973052b99aed8c6bcc442d1
BLAKE2b-256 fa4e21176a3f4eac73728b46dac546a377a73a9819ffbbf2d38f8777d37f0728

See more details on using hashes here.

File details

Details for the file lammps_step-2021.7.29-py2.py3-none-any.whl.

File metadata

  • Download URL: lammps_step-2021.7.29-py2.py3-none-any.whl
  • Upload date:
  • Size: 81.7 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.6

File hashes

Hashes for lammps_step-2021.7.29-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 360376ddf23ee02b9f35872f4838db68312ce16c520dcb6c7e43451270a5d435
MD5 f007f886a89654e0a61553fb4c943a71
BLAKE2b-256 4fa7aa216e7020b063fe15f243ade4272a304b1468156119910043b3e6ba4a69

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page