- Release
- Date
MDAnalysis (www.mdanalysis.org) is an object-oriented python toolkit to analyze molecular dynamics trajectories generated by CHARMM, Gromacs, Amber, NAMD, LAMMPS, DL_POLY and other packages; it also reads other formats (e.g., PDB files and XYZ format trajectories; see Supported coordinate formats
and Supported topology formats
for the full lists). 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-label
are implemented. Trajectories can also be manipulated (for instance, fit to a reference structure) and written out in a range of formats.
Please report bugs or enhancement requests through the Issue Tracker. Questions can also be asked on the mdnalysis-discussion mailing list.
The MDAnalysis community subscribes to a Code of Conduct that all community members agree and adhere to --- please read it.
The easiest approach to install the latest release is to use a package that can be installed either with pip or conda.
Installation with pip and a minimal set of dependencies:
pip install --upgrade MDAnalysis
To install with a full set of dependencies (which includes everything needed for MDAnalysis.analysis
), add the [analysis]
tag:
pip install --upgrade MDAnalysis[analysis]
First installation with conda:
conda config --add channels conda-forge
conda install mdanalysis
which will automatically install a full set of dependencies.
To upgrade later:
conda update mdanalysis
If you want to run the tests or use example files to follow some of the examples in the documentation or the tutorials, also install the MDAnalysisTests
package:
pip install --upgrade MDAnalysisTests # with pip
conda install mdanalysistests # with conda
Source code is available from https://github.com/MDAnalysis/mdanalysis/ under the GNU Public Licence, version 2. Obtain the sources with git
git clone https://github.com/MDAnalysis/mdanalysis.git
When using MDAnalysis in published work, please cite [Michaud-Agrawal2011] and [Gowers2016].
MDAnalysis also contains specific algorithms and whole analysis modules whose algorithms have also been published in the scientific literature. Please make sure to also reference any references-components
in published work.
Thank you!
./documentation_pages/overview ./documentation_pages/topology ./documentation_pages/selections ./documentation_pages/analysis_modules ./documentation_pages/topology_modules ./documentation_pages/coordinates_modules ./documentation_pages/converters ./documentation_pages/trajectory_transformations ./documentation_pages/selections_modules ./documentation_pages/auxiliary_modules ./documentation_pages/core_modules ./documentation_pages/visualization_modules ./documentation_pages/lib_modules ./documentation_pages/version ./documentation_pages/units ./documentation_pages/exceptions ./documentation_pages/references
genindex
modindex
search