MDAnalysis 2.0 is here

We are happy to release version 2.0.0 of MDAnalysis!

This is a new major version, and includes major API breaking changes in addition to a large number of updates and enhancements. This release concludes our current roadmap, an updated roadmap detailing our future steps will shortly be published.

This version supports Python 3.6 through to 3.9 on Windows (32- and 64-bit), MacOS, and Linux. It also offers preliminary support for ppc64le and ARM64, but does not currently support Apple M1 processors.

Support for legacy version of Python (e.g. 2.7 and 3.5) is only available in MDAnalysis 1.x releases.

Upgrading to MDAnalysis version 2.0.0

To install with conda from the conda-forge channel run

conda update -c conda-forge mdanalysis

To install from PyPi with pip run

pip install --upgrade MDAnalysis

For more help with installation see the installation instructions in the User Guide.

Notable new additions

There were many awesome contributions to MDAnalysis for version 2.0.0. Here we list a few notable example of these. For more information please see the CHANGELOG.

RDKit converter

Google Summer of Code student @cbouy implemented a new RDKit converter which allows for seamless conversions from RDKit to MDAnalysis structures. See @cbouy’s GSoC RDKit report for more information.

It currently accurately converts 90% of chemical space (based on ChEMBL27), but future changes will improve this.

OpenMM converter

@ahy3nz implemented an OpenMM converter which can read OpenMM objects directly into MDAnalysis.

Universe serialization

Google Summer of Code student @yuxuanzhuang implemented a means to serialize MDAnalysis.Universe objects, paving the way for parallel analysis. See @yuxuanzhuang’s GSoC Universe serialization report for more information.

Mean Square Displacement

@hmacdope implemented a new Mean Square Displacement analysis class.

Results class

@PicoCentauri implemented a Results class to store results from analysis classes. This change streamlines the API for analysis classe and paves the way for a soon-to-be released command line interface for MDAnalysis.

H5MD support

NSF REU student @edisj implemented both a reader and writer for the H5MD format.

Bond-Angle-Torsion coordinates

@daveminh implemented a means to translate from Cartesian to Bond-Angle-Torsion coordinates.

Important fixes

For a full list of bugfixes see the CHANGELOG. The following are selected fixes that may have lead to wrong results depending on your use case.


File formats


Changes to functionality


Author statistics

Altogether, this represents the work of 35 authors, 17 of which were new contributors:

MDAnalysis thanks NumFOCUS’s continued support as the organisation’s fiscal sponsor.