Skip to content
Molecular dynamics and Monte Carlo soft matter simulation on GPUs.
C++ Python Cuda CMake C Groovy Other
Branch: master
Clone or download
Latest commit 1743c67 Aug 5, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Remove python 2.7 CI testing May 22, 2019
.github Minor edits. Mar 13, 2019
.jenkins Merge branch 'maint' May 31, 2019
CMake Find python3 first Jul 3, 2019
doc Update copyrights Jan 24, 2019
example_plugin
hoomd Update changelog Aug 5, 2019
sphinx-doc Add branding to RTD page Jul 3, 2019
.gitignore Merge branch 'maint' Aug 22, 2017
.gitmodules Clean up random123 module inclusion Apr 2, 2019
.mailmap mootimot -> mtimc Mar 11, 2019
CHANGELOG.rst Update changelog Aug 5, 2019
CMakeLists.txt Merge branch 'mpcd-confined' into mpcd-force Apr 23, 2019
CMake_build_options.cmake add global compile time option ALWAYS_USE_MANAGED_MEMORY Sep 7, 2018
CMake_install_options.cmake Re-enable installs Mar 25, 2016
CMake_preprocessor_flags.cmake add global compile time option ALWAYS_USE_MANAGED_MEMORY Sep 7, 2018
CMake_src_setup.cmake Install headers and CMake scripts with the other hoomd files Jul 29, 2016
CMake_version_options.cmake Bump version to v2.6.0 May 24, 2019
CONTRIBUTING.md Minor edits. Mar 13, 2019
ContributorAgreement.md Format contributor agreement Mar 12, 2019
INSTALLING.rst Merge pull request #417 from glotzerlab/drop-py27 May 30, 2019
LICENSE Make license recognizable by github Mar 12, 2019
README.md Add branding to RTD page Jul 3, 2019
SourceConventions.md Reorganize contributor information. Feb 4, 2016
hoomd.sublime-project Add ninja build script to sublime text project Jan 10, 2017
hoomd_cache.cmake.in add missing flags for plug-ins Feb 14, 2019
hoomd_lint_detector.pl Ignore a few lint warnings Aug 30, 2016
readthedocs.yml Try rtd without conda Jan 24, 2019
setup.cfg Bump version to v2.6.0 May 24, 2019

README.md

HOOMD-blue

Citing HOOMD conda-forge conda-forge Downloads CircleCI Read the Docs Contributors License

HOOMD-blue is a general purpose particle simulation toolkit. It performs hard particle Monte Carlo simulations of a variety of shape classes, and molecular dynamics simulations of particles with a range of pair, bond, angle, and other potentials. HOOMD-blue runs fast on NVIDIA GPUs, and can scale across thousands of nodes. For more information, see the HOOMD-blue website.

Resources

Installation

HOOMD-blue binaries are available as containers (Docker Hub, Singularity Hub) and for Linux and macOS via the hoomd package on conda-forge. See the Installation Guide for instructions on installing HOOMD-blue or compiling from source.

Job scripts

HOOMD-blue job scripts are Python scripts. You can control system initialization, run protocols, analyze simulation data, or develop complex workflows all with Python code in your job.

Here is a simple example:

import hoomd
from hoomd import md
hoomd.context.initialize()

# Create a 10x10x10 simple cubic lattice of particles with type name A
hoomd.init.create_lattice(unitcell=hoomd.lattice.sc(a=2.0, type_name='A'), n=10)

# Specify Lennard-Jones interactions between particle pairs
nl = md.nlist.cell()
lj = md.pair.lj(r_cut=3.0, nlist=nl)
lj.pair_coeff.set('A', 'A', epsilon=1.0, sigma=1.0)

# Integrate at constant temperature
md.integrate.mode_standard(dt=0.005)
hoomd.md.integrate.langevin(group=hoomd.group.all(), kT=1.2, seed=4)

# Run for 10,000 time steps
hoomd.run(10e3)

Save this script as lj.py and run it with python lj.py (or singularity exec software.simg python3 lj.py if using Singularity containers).

Change log

See CHANGELOG.rst.

Contributing to HOOMD-blue

Contributions are welcomed via pull requests. Please report bugs and suggest feature enhancements via the issue tracker. See CONTRIBUTING.md for more information.

You can’t perform that action at this time.