University of Michigan Logo

HOOMD-blue is a general-purpose particle simulation toolkit. It scales from a single CPU core to thousands of GPUs.

You define particle initial conditions and interactions in a high-level python script. Then tell HOOMD-blue how you want to execute the job and it takes care of the rest. Python job scripts give you unlimited flexibility to create custom initialization routines, control simulation parameters, and perform in situ analysis.

Download and get started using HOOMD-blue today.

from hoomd_script import *
lj = pair.lj(r_cut=2.5)
lj.pair_coeff.set('A', 'A', epsilon=1.0, sigma=1.0)
integrate.nvt(group=group.all(), T=1.2, tau=0.5)
$ hoomd --mode=cpu
$ hoomd --mode=gpu
$ mpirun -n 256 hoomd --mode=cpu
$ mpirun -n 64 hoomd --mode=gpu

Fast GPU performance

On a single NVIDIA GPU, HOOMD-blue performs an order of magnitude faster than a multi-core CPU in typical benchmarks. Obtain faster time to solution, execute larger simulations than were previously possible, or increase job throughput through a cluster given a fixed monetary budget.


HOOMD-blue scales up to thousands of GPUs on Titan and Blue Waters, two of the largest GPU accelerated supercomputers in the world. It runs just as efficiently from one to dozens of GPUs on smaller clusters like Stampede (XSEDE), Maverick (XSEDE), your local GPU cluster, and the workstation at your desk.


Want to run a Molecular Dynamics simulation using a custom force field? Or maybe you are simulating granular dynamics, dissipative particle dynamics, or active particles? HOOMD-blue is the right tool for you, with a variety of potentials and integration modes. Mix and match any of these in your job script.

Molecular Dynamics capabilities


Apply any number of integrators to separate particle groups. HOOMD-blue has integrators built in for many different thermodynamic ensembles and energy minimization.

  • Langevin dynamics
  • Berendsen thermostat
  • Dissipative Particle Dynamics (DPD)
  • FIRE energy minimization

Pair potentials

  • DPD
  • Lennard-Jones
  • Gaussian
  • Moliere
  • Morse
  • Yukawa
  • ZBL
  • User-defined (table)

Bond potentials

  • Harmonic
  • FENE
  • User-defined (table)

Angle potentials

  • Harmonic
  • User-defined (table)

Rigid bodies

Combine particles together to form rigid bodies. Potentials still evaluate particle to particle, but the integrator keeps particles in rigid bodies together. HOOMD-blue contains the following rigid body integrators.

  • Langevin dynamics
  • Dissipative Particle Dynamics (DPD)
  • FIRE energy minimization

Many-body potentials

  • EAM
  • Tersoff

Long-ranged potentials

  • PPPM electrostatic

External potentials

  • Periodic
  • Wall
  • Constant force

Dihedral potentials

  • Harmonic
  • User-defined (table)

Improper potentials

  • Harmonic


  • Sphere

General features

Simulation box

Simulations in HOOMD-blue can be 2D or 3D. The box is a parallelepiped with arbitrary lengths and angles allowing for generic triclinic symmetry with periodic boundary conditions in all directions.


  • Random particle placement
  • Random polymer placement
  • Read XML input file
  • Set from python (arbitrary)
  • Replicate periodic box

Output files

  • DCD
  • MOL2
  • PDB
  • HOOMD-blue XML

Extend HOOMD-blue

Need a capability not listed here? Write a plugin that does what you need. HOOMD-blue plugins have full access to all particle properties, data structures, the GPU, domain decomposition and communication routines. Plugins that just add a new pair or bond potential don't even require CUDA code.

If your plugin is useful to a wide audience of users, submit it to the HOOMD-blue developers for inclusion into the main code.

Update properties

  • Resize box over time
  • Temperature rescale
  • Zero system momentum
  • Arbitrary manipulation of system and particle properties from python


  • Realtime visualization in VMD using IMD.
  • Mean-squared displacement
  • Log thermodynamic properties
  • Arbitrary analysis in python


  • 2014/03/18 - HOOMD-blue version 1.0.3 released
  • 2014/01/21 - HOOMD-blue version 1.0.2 released
  • 2014/01/20 - codeblue repository shut down, use bitbucket
  • 2014/09/09 - HOOMD-blue version 1.0.1 released