Skip to main content

An object-oriented toolkit to analyze molecular dynamics trajectories generated by CHARMM, Gromacs, NAMD, LAMMPS, or Amber.

Project description

MDAnalysis is an object-oriented python toolkit to analyze molecular dynamics trajectories generated by CHARMM, Gromacs, Amber, NAMD, or LAMMPS; it also reads other formats (e.g. PDB files and XYZ format trajectories; see the Table of Supported Coordinate Formats for details). It can write most of these formats, too, together with atom selections for use in Gromacs, CHARMM, VMD and PyMOL (see Selection exporters).

It allows one to read molecular dynamics trajectories and access the atomic coordinates through NumPy arrays. This provides a flexible and relatively fast framework for complex analysis tasks. Fairly complete atom selection commands are implemented. Trajectories can also be manipulated (for instance, fit to a reference structure) and written out in a range of formats.


Source code is available from under the GNU Public Licence, version 2, together with the online documentation. Packages can be downloaded from

or installed/upgraded via PyPI (using either easy_install or pip):

easy_install -U MDAnalysis
pip install --upgrade MDAnalysis

Please report bugs or enhancement requests through the Issue Tracker. Questions can also be asked on the mdnalysis-discussion mailing list.

In order to run the Unit Tests it is also necessary to install a separate package MDAnalysisTests containing the test and test data. As it contains about 18 MB of molecular dynamics trajectories and simulation system structures it is not included with the library itself.


When using MDAnalysis in published work, please cite

  • N. Michaud-Agrawal, E. J. Denning, T. B. Woolf, and O. Beckstein. MDAnalysis: A Toolkit for the Analysis of Molecular Dynamics Simulations. J. Comput. Chem. 32 (2011), 2319–2327. doi:10.1002/jcc.21787

PyPI Metadata

Project details

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page