Skip to main content

An object-oriented toolkit to analyze molecular dynamics trajectories.

Reason this release was yanked:

unintended release

Project description

Powered by NumFOCUS Github Actions Build Status Github Actions Cron Job Status Github Actions Linters Status Coverage Status

Documentation (latest release) Documentation (development version) User Google Group Developer Google Group Anaconda ASV Benchmarks

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.

NumFOCUS (Fiscally Sponsored Project)

This project is bound by a Code of Conduct.

Powered by MDAnalysis

If you use MDAnalysis in your project consider lettting 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 available under the GNU General Public License, version 2 (see the file LICENSE).

Contributing

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

If you are a new developer who would like to start contributing to MDAnalysis get in touch on the developer mailing list. 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

MDAnalysis-2.5.0.dev0-cp311-cp311-macosx_11_0_arm64.whl (3.3 MB view details)

Uploaded CPython 3.11 macOS 11.0+ ARM64

MDAnalysis-2.5.0.dev0-cp310-cp310-macosx_11_0_arm64.whl (3.3 MB view details)

Uploaded CPython 3.10 macOS 11.0+ ARM64

MDAnalysis-2.5.0.dev0-cp39-cp39-macosx_11_0_arm64.whl (3.3 MB view details)

Uploaded CPython 3.9 macOS 11.0+ ARM64

File details

Details for the file MDAnalysis-2.5.0.dev0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for MDAnalysis-2.5.0.dev0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7802b2b744340758a31e4bbce88a9bf65b6cf23043125ae7ed0410706a3d4a3c
MD5 989615b38eb3098dd8eba35733309022
BLAKE2b-256 b5dfcbec71441c70e7e56ad669dbfca766803579251324c1588543ca3c5c60c9

See more details on using hashes here.

Provenance

File details

Details for the file MDAnalysis-2.5.0.dev0-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for MDAnalysis-2.5.0.dev0-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 51f0964316aa70debf0bb7f3a949035355b95abfd592c19f46b6b43cdd2088dc
MD5 5711774d27f0fe3bd8e4c42956f8f21d
BLAKE2b-256 70dd509c38c5a9bf1097c38d83833b3e31c1d567bb2eeec7aec24b774e07fdbf

See more details on using hashes here.

Provenance

File details

Details for the file MDAnalysis-2.5.0.dev0-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for MDAnalysis-2.5.0.dev0-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c4c980bcccc2346c4937acf4a18b41416688014527119409afeb6e880cb3715d
MD5 acf828c30d34217001ff44f65050bc8c
BLAKE2b-256 709052cc55304d6cad9b26e4b4866e2f1d5b369a61f3f5f7f35628d637218d02

See more details on using hashes here.

Provenance

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