Need help with hoomd-blue?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

172 Stars 77 Forks BSD 3-Clause "New" or "Revised" License 18.1K Commits 96 Opened issues


Molecular dynamics and Monte Carlo soft matter simulation on GPUs.

Services available


Need anything else?

Contributors list


Citing HOOMD conda-forge conda-forge Downloads GitHub Actions Read the Docs Contributors License

HOOMD-blue is a Python package that runs simulations of particle systems on CPUs and GPUs. 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. Many features are targeted at the soft matter research community, though the code is general and capable of many types of particle simulations.


Example scripts

These examples demonstrate some of the Python API.

Hard particle Monte Carlo: ```python import hoomd

mc = hoomd.hpmc.integrate.ConvexPolyhedron() mc.shape['octahedron'] = dict(vertices=[ (-0.5, 0, 0), (0.5, 0, 0), (0, -0.5, 0), (0, 0.5, 0), (0, 0, -0.5), (0, 0, 0.5), ])

cpu = hoomd.device.CPU() sim = hoomd.Simulation(device=cpu, seed=20) sim.operations.integrator = mc

See HOOMD tutorial for how to construct an initial configuration 'init.gsd'

sim.createstatefrom_gsd(filename='init.gsd') ```

Molecular dynamics: ```python import hoomd

cell = lj = lj.params[('A', 'A')] = dict(epsilon=1, sigma=1) lj.r_cut[('A', 'A')] = 2.5

integrator = integrator.forces.append(lj) nvt =, filter=hoomd.filter.All(), tau=1.0) integrator.methods.append(nvt)

gpu = hoomd.device.GPU() sim = hoomd.Simulation(device=gpu) sim.operations.integrator = integrator

See HOOMD tutorial for how to construct an initial configuration 'init.gsd'

sim.createstatefromgsd(filename='init.gsd') sim.state.thermalizeparticle_momenta(filter=hoomd.filter.All(), kT=1.5) ```

Change log

CHANGELOG.rst contains the full change log.

Contributing to HOOMD-blue

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


HOOMD-blue is available under the 3-clause BSD license.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.