HOOMD-TF

HOOMD-TF: GPU-Accelerated, Online Machine Learning in the HOOMD-blue Molecular Dynamics Engine - Published in JOSS (2020)

https://github.com/ur-whitelab/hoomd-tf

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org
  • Committers with academic emails
    3 of 13 committers (23.1%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords

machine-learning molecular-dynamics tensorflow

Scientific Fields

Sociology Social Sciences - 87% confidence
Last synced: 4 months ago · JSON representation

Repository

A plugin that allows the use of Tensorflow in Hoomd-Blue for GPU-accelerated ML+MD

Basic Info
Statistics
  • Stars: 32
  • Watchers: 5
  • Forks: 8
  • Open Issues: 9
  • Releases: 14
Topics
machine-learning molecular-dynamics tensorflow
Created about 7 years ago · Last pushed over 1 year ago
Metadata Files
Readme License

README.md

HOOMD-TF

status Documentation Status Build Stats

This plugin enables the use of TensorFlow in a HOOMD-blue simulation to compute quantities like forces and collective variables and do learning while running a simulation. You may also use it without hoomd-blue to process trajectories via MDAnalysis. Please see here for documentation for install and usage instructions.

HOOMD-TF can be used for a variety of tasks such as online force-matching, online machine learning in HOOMD-blue simulations, and arbitrary collective variable calculations using TensorFlow tensor operations. Because both HOOMD-blue and TensorFlow are GPU-accelerated, HOOMD-TF was designed with speed in mind, and minimizes latency with a GPU-GPU communication scheme. Of particular interest, HOOMD-TF allows for online machine learning with early termination, rather than the more tradditional batch learning approach for MD+ML.

HOOMD-TF includes several utility functions as convenient built-ins, such as: * RDF calculation * EDS Biasing (See this paper) * Coarse-Grained simulation force matching

In addition to all these, the TensorFlow interface of HOOMD-TF makes implementing arbitrary ML models as easy as it is in TensorFlow, by exposing the HOOMD-blue neighbor list and particle positions to TensorFlow. This enables GPU-accelerated tensor calculations, meaning arbitrary collective variables can be treated in the TensorFlow model framework, as long as they can be expressed as tensor operations on particle positions or neighbor lists.

Tutorials

See example notebooks here to learn about what HOOMD-TF can do.

Prerequisites

The following packages are required to compile:

tensorflow >= 2.3
hoomd >= 2.6
tbb-devel (only for hoomd if installed with conda)

tbb-devel is required when using the HOOMD-blue conda release. It is not automatically installed when installing HOOMD-blue, so use conda install -c conda-forge tbb-devel to install. The TensorFlow version should be TensorFlow 2.3 release. It is recommended you install via pip.

Citation

Please use the following citation:

HOOMD-TF: GPU-Accelerated, Online Machine Learning in the HOOMD-blue Molecular Dynamics Engine. R Barrett, M Chakraborty, DB Amirkulova, HA Gandhi, G Wellawatte, and AD White (2020) Journal of Open Source Software doi: 10.21105/joss.02367

© HOOMD-TF Developers

Owner

  • Name: White Laboratory
  • Login: ur-whitelab
  • Kind: organization

JOSS Publication

HOOMD-TF: GPU-Accelerated, Online Machine Learning in the HOOMD-blue Molecular Dynamics Engine
Published
July 28, 2020
Volume 5, Issue 51, Page 2367
Authors
Rainier Barrett ORCID
University of Rochester Chemical Engineering Department, Rochester, New York, United States of America
Maghesree Chakraborty ORCID
University of Rochester Chemical Engineering Department, Rochester, New York, United States of America
Dilnoza B. Amirkulova ORCID
University of Rochester Chemical Engineering Department, Rochester, New York, United States of America
Heta A. Gandhi ORCID
University of Rochester Chemical Engineering Department, Rochester, New York, United States of America
Geemi P. Wellawatte ORCID
University of Rochester Chemistry Department, Rochester, New York, United States of America
Andrew D. White ORCID
University of Rochester Chemical Engineering Department, Rochester, New York, United States of America
Editor
Richard Gowers ORCID
Tags
molecular dynamics machine learning

GitHub Events

Total
  • Issues event: 1
  • Watch event: 2
Last Year
  • Issues event: 1
  • Watch event: 2

Committers

Last synced: 5 months ago

All Time
  • Total Commits: 561
  • Total Committers: 13
  • Avg Commits per committer: 43.154
  • Development Distribution Score (DDS): 0.266
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Andrew White w****w@g****m 412
RainierBarrett r****t@g****m 54
Heta Gandhi h****i@u****u 35
geemi725 4****5 22
Mehrad Ansari 5****2 14
MAGHESREE CHAKRABORTY m****2@b****e 10
DILNOZA AMIRKULOVA d****l@b****e 4
Dilnoza Amirkulova d****2 3
Ziyue Yang 3****7 2
MAGHESREE CHAKRABORTY m****2@b****e 2
Sara Ali s****4@r****u 1
oktak o****k 1
HETA ANILKUMAR GANDHI h****i@b****u 1

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 47
  • Total pull requests: 54
  • Average time to close issues: 3 months
  • Average time to close pull requests: 8 days
  • Total issue authors: 5
  • Total pull request authors: 7
  • Average comments per issue: 1.15
  • Average comments per pull request: 1.24
  • Merged pull requests: 49
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • whitead (38)
  • RainierBarrett (5)
  • hgandhi2411 (2)
  • geemi725 (1)
  • dilnoza92 (1)
Pull Request Authors
  • whitead (27)
  • RainierBarrett (9)
  • hgandhi2411 (6)
  • geemi725 (4)
  • mchakra2 (4)
  • dilnoza92 (3)
  • oktak (1)
Top Labels
Issue Labels
bug (5) Hacktoberfest (5) enhancement (3)
Pull Request Labels
WIP (1)

Dependencies

requirements.txt pypi
  • NetworkX *
  • hoomd >=2.6.0
  • mdanalysis <=1.1.1
  • tensorflow >=2.3
sphinx-docs/docs_requirements.txt pypi
  • autodocs *
  • mock *
  • sphinx *
  • sphinx-rtd-style *
  • sphinx_rtd_theme *
.github/workflows/test.yml actions
  • actions/checkout v2 composite
  • s-weigand/setup-conda v1.0.5 composite