MDAnalysis is a Python library for the analysis of computer simulations of many-body systems at the molecular scale, spanning use cases from interactions of drugs with proteins to novel materials. It is widely used in the scientific community and is written by scientists for scientists.
It works with a wide range of popular simulation packages including Gromacs, Amber, NAMD, CHARMM, DL_Poly, HooMD, LAMMPS and many others — see the lists of supported trajectory formats and topology formats. MDAnalysis also includes widely used analysis algorithms in the MDAnalysis.analysis module.
The MDAnalysis project uses an open governance model and is fiscally sponsored by NumFOCUS. Consider making a tax-deductible donation to help the project pay for developer time, professional services, travel, workshops, and a variety of other needs.
This project is bound by a Code of Conduct.
If you use MDAnalysis in your project consider letting your users and the world know about it by displaying the MDAnalysis badge! Embedding code is available for different markups.
Example analysis script
import MDAnalysis as mda
# Load simulation results with a single line
u = mda.Universe('topol.tpr','traj.trr')
# Select atoms
ag = u.select_atoms('name OH')
# Atom data made available as Numpy arrays
ag.positions
ag.velocities
ag.forces
# Iterate through trajectories
for ts in u.trajectory:
print(ag.center_of_mass())Documentation
New users should read the Quickstart Guide and might want to look at our videos, in which core developers explain various aspects of MDAnalysis.
All users should read the User Guide.
Developers may also want to refer to the MDAnalysis API docs.
A growing number of tutorials are available that explain how to conduct RMSD calculations, structural alignment, distance and contact analysis, and many more.
Installation and availability
The latest release can be installed via pip or conda as described in the Installation Quick Start.
Source code is hosted in a git repository at https://github.com/MDAnalysis/mdanalysis and is packaged under the GNU Lesser General Public License, version 3 or any later version (LGPLv3+). Individual source code components are provided under the GNU Lesser General Public License, version 2.1 or any later version (LGPLv2.1+). Please see the file LICENSE for more information.
Contributing
Please report bugs or enhancement requests through the Issue Tracker. Questions can also be asked on GitHub Discussions.
If you are a new developer who would like to start contributing to MDAnalysis get in touch on GitHub Discussions. To set up a development environment and run the test suite read the developer guide.
Citation
When using MDAnalysis in published work, please cite the following two papers:
R. J. Gowers, M. Linke, J. Barnoud, T. J. E. Reddy, M. N. Melo, S. L. Seyler, D. L. Dotson, J. Domanski, S. Buchoux, I. M. Kenney, and O. Beckstein. MDAnalysis: A Python package for the rapid analysis of molecular dynamics simulations. In S. Benthall and S. Rostrup, editors, Proceedings of the 15th Python in Science Conference, pages 102-109, Austin, TX, 2016. SciPy. doi: 10.25080/Majora-629e541a-00e
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
For citations of included algorithms and sub-modules please see the references.
5 maintainers
Metadata
5 maintainers
Release files for MDAnalysis 2.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mdanalysis-2.9.0.tar.gz | 5.2 MB | Details |
Built distributions (wheels)
Total release size: 134.0 MB
Release files / mdanalysis-2.9.0.tar.gz
| Download URL | mdanalysis-2.9.0.tar.gz |
|---|---|
| Size | 5.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fe7a4ac33e7a5c1001d954667d7e630aeb26cab6f8917fdbac6ffad903999497
|
|
BLAKE2b-256 checksum How to use checksums |
9e0bad2805c66246cbc9b7dca5a086316da0687135b5c6786da7b75ea9e1622d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp313-cp313-win_amd64.whl
| Download URL | mdanalysis-2.9.0-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 6.4 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
af06687aa5431d0495ffa2f5f86f9d9572d167daa2bb188396ef7a83ef7caad3
|
|
BLAKE2b-256 checksum How to use checksums |
4021a968e3a3bd65d5b285c2c0ea2b8044f82c3e576bd4d28a2b7cb04b07abba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | mdanalysis-2.9.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 12.8 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
e4cfa6fb8e9911556461e6b31adc14fb8a2274ffe39c9171b9e5df52e08376c9
|
|
BLAKE2b-256 checksum How to use checksums |
f1372860b0c101b6037023c0b6decb8893f382d765dbe969a139f933d6551eb3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | mdanalysis-2.9.0-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4d663627d104b6a57d618afac60a2e86fc7452080b921c8b1b399aa77ed16c63
|
|
BLAKE2b-256 checksum How to use checksums |
f69c7fe12c2da25071a61e05bc17615ea9d8bd2069ec6c5f5268899133c411f8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp313-cp313-macosx_10_13_x86_64.whl
| Download URL | mdanalysis-2.9.0-cp313-cp313-macosx_10_13_x86_64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.13 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
164cf71ced0c202683c53a3c5eb66d5d88cb14cbe52f0c5eb3c80a5dbb79a4bd
|
|
BLAKE2b-256 checksum How to use checksums |
b64ca8ab61891fdd0fe49528e202d14ac6b3f4bb1adc11dff5f00b0509f4c38e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp312-cp312-win_amd64.whl
| Download URL | mdanalysis-2.9.0-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 6.4 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
7a2ea6388a4af7af5734d5d248d2c127d1548f465efa2eff6aa5d9ab9b674112
|
|
BLAKE2b-256 checksum How to use checksums |
0ba7043d4f83baef204b943aa95c2f4defc3f70a86dd17969394b6702b3c361d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | mdanalysis-2.9.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 12.9 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
486714919f08fe18f98bf80bec404dbc4face94803c1775d88340a148503683d
|
|
BLAKE2b-256 checksum How to use checksums |
a24f31c87a03b0ae25fd9315704167d565a942cacca446fcbaf76a669c6e85d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | mdanalysis-2.9.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
8465e9a3b45ce6c188bdba472a27b80f1144b0c7127b8c4ed0156033bebfb5b6
|
|
BLAKE2b-256 checksum How to use checksums |
38a175f01707e41c30191908d134ea4917d3d6bdd3a525b59283e8970b57969a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | mdanalysis-2.9.0-cp312-cp312-macosx_10_13_x86_64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.12 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
18f5207a7b0098e2837ddef8eb7cd2a8db70aa1e9f11e014189e5d923914ce21
|
|
BLAKE2b-256 checksum How to use checksums |
49bd6c15e33c08e8a15d9526d3662317bee73623340571cae32be3ee3c9bcc6b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp311-cp311-win_amd64.whl
| Download URL | mdanalysis-2.9.0-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 6.4 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
ca3e1e1b26683e8f5efd96d9b3cb84da1ee463136017113ee860d651224e7afb
|
|
BLAKE2b-256 checksum How to use checksums |
369e686eb5e6b8d251ae1659a9e1bca01271eaeef3309cc3c17f54f6254d87b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | mdanalysis-2.9.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 13.0 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
13951ccb5c03e3c79ee5bbd4670fcece7060622161989b5eb2c389321f0df218
|
|
BLAKE2b-256 checksum How to use checksums |
790a4a188b1027da4335f9fda8ed4a57e16bfdc8c0bcd24a3538b88cd32bfbb1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | mdanalysis-2.9.0-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c5ad6fa37ca6e14f403375d95fcb86be43bc1067ce401fe30105deac6eaa3e51
|
|
BLAKE2b-256 checksum How to use checksums |
b2f922d172baaa9f7835e3bff8cc47556994e847706f9674b3d885017da670c4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp311-cp311-macosx_10_9_x86_64.whl
| Download URL | mdanalysis-2.9.0-cp311-cp311-macosx_10_9_x86_64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.11 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
68f4f710f7c0ced95630cb5a6e5a1e61038f207106a963879cfecaebb4e6ca29
|
|
BLAKE2b-256 checksum How to use checksums |
0fe7d6847d62dcddb2840c34a2a5b1c11719a6555960870bd30009bd28785af3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp310-cp310-win_amd64.whl
| Download URL | mdanalysis-2.9.0-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 6.4 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
85369de6296491d39b97023bdee599fe5f07ec678d60efb5390b5aefc576783c
|
|
BLAKE2b-256 checksum How to use checksums |
4a98c9a6b2d8fb0abefe3f512518fecb5497de106ced1ce9cc62b6ba40702926
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | mdanalysis-2.9.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 12.5 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
0d6e5d62eb8c728549543ae4feb8a024494698cc7914d31169808a4b8f3efe3c
|
|
BLAKE2b-256 checksum How to use checksums |
2c7de8fa40165c3e84f179cc1176b43c0177de1507fb5f518e6c30ba9d1c7569
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | mdanalysis-2.9.0-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
88d0653d7f9ef5ce65bd63a5ce76284dbaa002262cc731a1cc2e2eef82ba8d97
|
|
BLAKE2b-256 checksum How to use checksums |
8ff65e6ee36b67d55749f6c8c60a5eceb019f31c4a077e1fa45e807e2896e665
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency logRelease files / mdanalysis-2.9.0-cp310-cp310-macosx_10_9_x86_64.whl
| Download URL | mdanalysis-2.9.0-cp310-cp310-macosx_10_9_x86_64.whl |
|---|---|
| Size | 6.6 MB |
| Tags | CPython 3.10 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
1c39ca99fc822bc4aed686f9b636bc8af489d9cbf1f7d7def65894a0afeaec8a
|
|
BLAKE2b-256 checksum How to use checksums |
36b54e50bf4bc63dbf51ea3f6371ab8f27ef6e49f2a295d0a873e0093e16a71d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2025.
Transparency log
