Skip to main content

MDDatasetBuilder

DOI:10.1038/s41467-020-19497-z Citations python version PyPI codecov Research Group

MDDatasetBuilder is a script to construct reference datasets for the training of neural network potentials from given LAMMPS trajectories.

Complex reaction processes in combustion unraveled by neural network-based molecular dynamics simulation, Nature Communications, 11, 5713 (2020), DOI: 10.1038/s41467-020-19497-z

Installation

MDDatasetBuilder can be installed with pip:

pip install mddatasetbuilder

The installation process should be very quick, taking only a few minutes on a “normal” desktop computer.

Usage

Simple example

A LAMMPS dump file should be prepared. A LAMMPS bond file can be added for the addition information.

datasetbuilder -d dump.ch4 -b bonds.reaxc.ch4_new -a C H O -n ch4 -i 25

Here, dump.ch4 is the name of the dump file. bonds.reaxc.ch4_new is the name of the bond file, which is optional. C H O is the element in the trajectory. ch4 is the name of the dataset. 25 means the time step interval and the default value is 1.

Then you can generate Gaussian input files for each structure in the dataset and calculate the potential energy & atomic forces (assume the Gaussian 16 has already been installed.):

qmcalc -d dataset_ch4_GJf/000
qmcalc -d dataset_ch4_GJf/001

Next, prepare a DeePMD dataset and use DeePMD-kit to train a NN model.

preparedeepmd -p dataset_ch4_GJf
cd train && dp train train.json

The runtime of the software depends on the amount of data. It is more suited to running on a server rather than desktop computer.

DP-GEN

DOI:10.1021/acs.energyfuels.0c03211 Citations

In a follow-up work, the MDDatasetBuilder package has been integrated with DP-GEN software as a part of the DP-GEN workflow:

dpgen init_reaction reaction.json machine.json

See DP-GEN documentation for details. Arguments of reaction.json can be found here. machine.json is described here, where reaxff_command is the LAMMPS command (lmp), build_command is the MDDatasetbuilder command (datasetbuilder), and fp_command is the Gaussian 16 command (g16 < input || :).

The genereated data can be used to continue DP-GEN concurrent learning workflow. Read Energy & Fuels, 2021, 35 (1), 762–769 for details.

Download files

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

Source Distribution

mddatasetbuilder-1.3.8.tar.gz (30.7 kB view details)

Uploaded Source

Built Distributions

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

mddatasetbuilder-1.3.8-cp37-abi3-win_amd64.whl (39.2 kB view details)

Uploaded CPython 3.7+Windows x86-64

mddatasetbuilder-1.3.8-cp37-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (84.3 kB view details)

Uploaded CPython 3.7+manylinux: glibc 2.17+ x86-64manylinux: glibc 2.5+ x86-64

mddatasetbuilder-1.3.8-cp37-abi3-macosx_10_9_x86_64.whl (36.6 kB view details)

Uploaded CPython 3.7+macOS 10.9+ x86-64

mddatasetbuilder-1.3.8-cp37-abi3-macosx_10_9_universal2.whl (48.0 kB view details)

Uploaded CPython 3.7+macOS 10.9+ universal2 (ARM64, x86-64)

File details

Details for the file mddatasetbuilder-1.3.8.tar.gz.

File metadata

  • Download URL: mddatasetbuilder-1.3.8.tar.gz
  • Upload date:
  • Size: 30.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for mddatasetbuilder-1.3.8.tar.gz
Algorithm Hash digest
SHA256 98054e36cc27db2ad1cc2a7908fd2d25da748f8295211f6887bf2318399aee2d
MD5 ff3cd1d8630a6dae7ecbbde1cb4a8e8a
BLAKE2b-256 09d2a68e525f64a1b52f0ef6e8c72f7846aaec5e9305be1429a9f62ca75a57fd

See more details on using hashes here.

File details

Details for the file mddatasetbuilder-1.3.8-cp37-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for mddatasetbuilder-1.3.8-cp37-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 b4dc3b27f59493ebc6ed330939b72954752941e65113581d3dac61e6bf6fa242
MD5 bb0b6a7f0a68ce55232400143d47f76d
BLAKE2b-256 b3b8923dae506fa60b2379039793d54a4e81a3faba156b7654dd31e5440acdaf

See more details on using hashes here.

File details

Details for the file mddatasetbuilder-1.3.8-cp37-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for mddatasetbuilder-1.3.8-cp37-abi3-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 0603b9c9de19ff99bc89575862d22975f0e731afdbe274df5c92b724d32946db
MD5 d2682a703eb1d411451dd3d7e642104f
BLAKE2b-256 a4d6a293f08b850d24eb04a1b26aae76278708cfdb9c844d5ed30c000a27a006

See more details on using hashes here.

File details

Details for the file mddatasetbuilder-1.3.8-cp37-abi3-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for mddatasetbuilder-1.3.8-cp37-abi3-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 8e0192895d354800a541b8cb6d444616a2f5cb04f3ce2b12fcea6c0003a111c0
MD5 3fe7633e8b11d69ffdf29807f28d01b4
BLAKE2b-256 e2b3f34aba4cbf7b29fb71b5b49c0d3c5ffa452486a283f55e164387b177d17a

See more details on using hashes here.

File details

Details for the file mddatasetbuilder-1.3.8-cp37-abi3-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for mddatasetbuilder-1.3.8-cp37-abi3-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 cb2c553e1ca8a64c4203d14aad1aa1e5f0f7eeb82d2954a70240000139022730
MD5 82f5672e3ff2b282d2e0a66dbe1b42dc
BLAKE2b-256 ef53c43edb732c9e181f05b21c3cf09a4c749a6b2636ec903fcb7c8dcab3f8c7

See more details on using hashes here.

Release history Release notifications | RSS feed

1.3.10

4 files

1.3.9

4 files

This release

1.3.8 This release

5 files

1.3.7

5 files

1.3.5

16 files

1.3.4

1 file

1.3.3

1 file

1.3.2

1 file

1.3.1

1 file

1.3.0

1 file

1.2.23

1 file

1.2.22

1 file

1.2.21

1 file

1.2.20

1 file

1.2.3

1 file

1.2.2

1 file

1.2.1

1 file

1.2.0

1 file

1.1.13

1 file

1.1.12

1 file

1.1.11

1 file

1.1.10

1 file

1.1.9

1 file

1.1.8

1 file

1.1.7

1 file

1.1.6

1 file

1.1.5

1 file

1.1.4

1 file

1.1.3

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page