Skip to content

automatic generation of LAMMPS input files for molecular dynamics simulations of MOFs

License

Notifications You must be signed in to change notification settings

MOFplus/lammps_interface

 
 

Repository files navigation

Build Status Docs status PyPI version

LAMMPS Interface

Authors

  • Peter Boyd
  • Mohamad Moosavi
  • Matthew Witman

to be blamed for the crippled version:

  • Rochus Schmid [RUB/MOF+]

Description

This program was designed for easy interface between the crystallographic information file (.cif) and the Large-scale Atomic Molecular Massively Parallel Simulator (Lammps).

The modified version can not read a file anymore but gets a mol object (MOFplus/molsys) and creates only UFF or UFF4MOF input for lammps with the pylmps wrapper. NOTE: If you want to use this code for its orginal purpose use the original code. No reading of CIF files possible.

Installation

Simply install from PyPI:

pip install lammps-interface

For development purposes, clone the repository and install it from source:

pip install -e .

Note: In both cases, this adds lammps-interface to your PATH.

Usage

Command line interface

To see the optional arguments type:

lammps-interface --help

To create Lammps simulation files for a given cif file type:

lammps-interface cif_file.cif

This will create Lammps simulation files with UFF parameters.

Jupyter notebook

In order to integrate lammps-interface into your project, check out the Jupyter notebooks provided in /notebooks for usage examples.

License

MIT license (see LICENSE)

Citation

The publication associated with this code is found here:

Boyd, P. G., Moosavi, S. M., Witman, M. & Smit, B. Force-Field Prediction of Materials Properties in Metal-Organic Frameworks. J. Phys. Chem. Lett. 8, 357–363 (2017).

https://dx.doi.org/10.1021/acs.jpclett.6b02532

About

automatic generation of LAMMPS input files for molecular dynamics simulations of MOFs

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 99.4%
  • Jupyter Notebook 0.6%