Towards MDAnalysis 3.0


MDAnalysis is beginning to plan for our 3.0 release! Following discussions at our first UGM, we (the MDAnalysis Core Developers) have decided on a set priorities for this exciting milestone (detailed below). Our primary goals can be divided into several main themes.

A trimmed down core library

As MDAnalysis continues to grow along with the field of molecular simulations, we are aiming to continue to provide a highly functional, easily maintainable package that can be the foundation of a wide variety of downstream tools.

Following the successful introduction of the MDAKits ecosystem (modelled on the SciKit ecosystem, see the MDAKits paper) as part of our EOSS4 work, which provides infrastructure for creating FAIR packages that address specific scientific questions in the analysis of molecular simulation, we are aiming to move some more specialized analyses currently present in the MDAnalysis core library to MDAKits. Several analysis modules, including hole2 (pore and cavity analysis), encore (ensemble similarity analysis), psa (path similarity analysis), helanal (helix orientation) and waterdynamics (water orientation and dynamicss) will become stand-alone MDAKits and are going to be removed from MDAnalysis.analysis in 3.0. Some of these packages are already deployed as MDAKits and are deprecated in the core library.

This change will allow for a reduction in the core dependencies of MDAnalysis and reduce the maintenance burden of specialist analyses in the core library. This will also empower those developing specialist analysis code to rapidly develop and prototype their code in well supported downstream packages. Additionally, core developers will be able to spend more cycles on core competencies, fixing critical issues and planning future improvements, ensuring that MDAnalysis can be easily and effectively maintained for years to come.

For at least the 3.x life cycle, the MDAnalysis development team will fully maintain MDAKits that have been moved out of the core (unless other maintainers take over). We are, however, very much looking for community members who are willing to participate in MDAKit maintenance or want to take over maintenance of a kit. If some functionality is important for your research, work with us: We will teach you the basics of package maintenance and you will perform a great service to the molecular simulation community!


We have identified several areas that we would like to target for future improvement of MDAnalysis across four key themes.

  1. Improving interoperability
    • Add support for new formats
    • Moving converters to MDAKits
    • Improve interoperability with chemoinformatics and simulation software
  2. Scientifically aware operations
    • Improve guessers to enable context-dependent chemical information to be easily inferred
    • Make MDAnalysis more chemoinformatics-aware
    • Improve support for units and unit systems
  3. Support for streaming and cloud storage
    • Add support for generic streams in file readers
    • Enable reading of trajectories and topologies directly from cloud storage (eg AWS S3)
  4. Enhanced parallelism and performance
    • Improve performance of key distance routines with distopia
    • Create a compiled backend for ASCII topology and coordinate readers
    • Redesign precision model in MDAnalysis internals to guarantee user-controlled precision
    • Add support for parallelism via a Dask based parallel backend (continuation of a GSOC project)

We aim to lay the groundwork for these future directions in our work for MDAnalysis 3.0.

User facing API changes

We are also planning to clear up some API inconsistencies scattered across the library that require an API break, including some instances where coordinate readers behave differently relative to each other, renaming some arguments to clearer names and addressing other miscellanea. Additionally, we are aiming to provide a more consistent and usable low-level Cython API surface that compiled extensions can hook into. We are also investigating the feasibility of improving consistency of precision handling in various parts of the MDAnalysis core library, as the use of double and mixed precision has been identified as a key performance bottleneck.

Improving organization structure and formalising roles and responsibilities.

We have identified that assigning direct roles and responsibilities across our Core Developers is a change that will be beneficial for the health of our community going forward. To this end we are workshopping a more formal organization structure that will make our internal processes more transparent and allow more functional redundancy in key roles. Watch this space!

If you have any feedback on this roadmap or would like to discuss our future plans with us, contact us on our Discord or mailing list.

– Hugo MacDermott-Opeskin on behalf of the MDAnalysis Core Developers

An update on relicensing the MDAnalysis library (towards LGPLv2.1+)

⚠️ Disclaimer The MDAnalysis core team members are not lawyers. As such the information provided here does not, and is not intended to constitute legal advice. This blog post also does not represent MDAnalysis’ full legal position on software licensing; it simply aims to inform MDAnalysis developers and users on certain aspects of the MDAnalysis relicensing efforts and how we think it may impact them going forward.

Further information on open-source software licensing can be found from sources such as the Open Source Initiative, tl;dr Legal and the Software Sustainability Institute.

Should you have any concerns about licensing, we always strongly recommend getting legal advice before making any decisions on how licensing changes may affect you.

Table of contents

Short description

This blog post provides an update on MDAnalysis’ proposed license change. Specifically, we outline our decision to opt for a GNU Lesser General Public License v2.1+ (LGPL v2.1+) instead of the previously communicated GNU Lesser General Public License v3+ (LGPL v3+).

We also detail some interim changes to the MDAnalysis package license, alongside some upcoming actions for library contributors.


In November of 2022 the MDAnalysis team announced a proposal to change the license of its core library from the GNU General Public License v2+ to the GNU Lesser General Public License v3+. The full rationale for this change can be found here and mainly centered around three main arguments:

  1. Allowing downstream codes to freely import or link to the MDAnalysis library with minimal worry about the license they choose to use.
  2. Allowing downstream codes to use and subclass any MDAnalysis components under its application programming interface (classes, methods, and data objects), without incurring copyleft and restricting the license choice of the downstream code.
  3. Ensuring that codes that either directly copy or extend the MDAnalysis library’s source code would fall under the copyleft license requirements of the MDAnalysis library license. Doing so would ensure that the eventual license would more closely match the original intent of the historical GPL v2+ contributions which were kindly donated to MDAnalysis over the years.

It is our view that a weak copyleft license, such as the GNU Lesser General Public License would best match these requirements.

Upon announcing the proposed license change, we engaged in a consultation period where we encouraged members of the community to comment on and ask questions about the proposed relicensing efforts. Overall, the community response was overwhelmingly positive, and led to some very fruitful discussions. We would like to thank all members of the community who participated. Some interesting points were brought to our attention, particularly when it came to the range of licenses compatible with LGPL v3+. This raised a lot of questions about the suitability of LGPL v3+, and the current status of the MDAnalysis GPL v2+ package license, so we decided to pause the relicensing process whilst we worked with our legal counsel to find an appropriate path forward.

After careful consideration we have decided to aim for a license change to the LGPL v2.1+ via interim package license changes to GPL v3+ and LGPL v3+.

In this post we will provide our rationale for this change, alongside key information for how we will be enacting these changes.

License changes will affect how users and developers will interact with the MDAnalysis code base going forward. We urge all members of the community to read this post and get in touch with the MDAnalysis core developer team should you have any questions or concerns.

Rationale for our change in target license

Table 1: MDAnalysis’ view of the dynamic linking license compatibility matrix. License pairs detailed with a compatibility of “No” have claimed incompatibilities between their license terms. License pairs detailed as “Yes (copyleft)” are compatible but may incur copyleft through the interacting GNU GPL license. License pairs detailed with the compatibility “Yes” are, to our knowledge, fully compatible without incurring any copyleft.

License GPL v2 GPL v3 LGPL v2.1 LGPL v3 Apache 2.0 MIT BSD 3.0
GPL v2 Yes No [1] Yes (copyleft) No [1] No Yes (copyleft) Yes (copyleft)
GPL v3 No [1] Yes No [2] Yes (copyleft) Yes (copyleft) Yes (copyleft) Yes (copyleft)
LGPL v2.1 Yes (copyleft) No Yes No [2] No Yes Yes
LGPL v3 No [1] Yes (copyleft) No [2] Yes Yes Yes Yes
Apache 2.0 No Yes (copyleft) No Yes Yes Yes Yes
MIT Yes (copyleft) Yes (copyleft) Yes Yes Yes Yes Yes
BSD 3.0 Yes (copyleft) Yes (copyleft) Yes Yes Yes Yes Yes

[1] Compatible if the GPL v2 license is provided under the “or any later version” terms. [2] Compatible if the LGPL v2.1 license is provided under the “or any later version” terms.

Why LGPL v2.1+ instead of LGPLv3+?

During the community consultation, it was brought to our attention that by choosing an LGPL v3+ license, it would no longer be compatible with older versions of the GNU General Public License, namely GPL v2 and LGPL v2.1 (see Table 1). The reasons for this are complex and we will not attempt to explain them here, we will instead refer the reader to the FSF GPL license compatibility FAQ entry for further details.

Overall the impact of this incompatibility is likely very low. Few codes are solely licensed under GPL v2 or LGPL v2.1, with most under “or any later version” terms, allowing the codes to relicense under a later version and avoiding this issue entirely. However, this would still require several downstream packages to update their package license, which is not an insignificant amount of work. It is our view that it is best for the community that we try to avoid this issue, especially given that the MDAnalysis library itself has historically been released under GPL v2+.

Our solution is instead to compromise and try to ultimately relicense MDAnalysis under the terms of the LGPL v2.1+. This would allow other libraries to interact with MDAnalysis under either the terms of LGPL v2.1, LGPL v3, or any as of yet unreleased future versions of the GNU Lesser General Public License. This does mean that the MDAnalysis library would not fully benefit from some of the newer protections and clarifications introduced in the LGPL v3 license, but we do not believe this to have a significant impact on how we expect the library to be developed and used.

Why the interim GPL v3+ and LGPL v3+ package licenses? (The issue with Apache 2.0).

Whilst reviewing the compatibility of GNU GPL licenses, we were made aware of a likely incompatibility between the Apache 2.0 license and either GPL v2 or LGPL v2.1. The exact details are again quite complex and murky, and we would instead refer you to Heather Meeker’s opinion (Open Source for Business, 3rd Ed.) on the matter. Nevertheless, it is our understanding that the prevalent opinion is that (L)GPLv2 codes cannot dynamically link to Apache 2.0 codes, something which the MDAnalysis library has historically been doing by depending on the fasteners and mmtf-python packages.

Both of these packages bring important core functionality to MDAnalysis and cannot be quickly removed without impacting the user experience. We believe that this is something we can do as we move towards a v3.0 release of MDAnalysis, replacing the use of fasteners with alternatives such as py-filelock and removing the ability to read MMTF files in favor newer PDB file formats. As this will likely take some time, we will temporarily change our package license to GPL v3+, which we have already done as part of the 2.6.0 release of MDAnalysis. We may also possibly go through an interim LGPL v3+ license, before reaching our final LGPL v2.1+ package license. Further details how we see the license process to occur can be found later in this blog.

We note that we can make these changes to the MDAnalysis package license without requiring sign offs from all developers as the library’s source code license will still remain under GPL v2+ (and eventually LGPL v2.1+). This allows us to release the package under any appropriate license version of the GNU GPL. It does however mean that we will be temporarily at risk of downstream packages encountering the previously mentioned incompatibilities between GPL v2 and GPL v3. Should this impact you, please get in touch with the core developer team and we will attempt to explore alternative packaging solutions.

Why not opt for a more permissive (and likely less complicated) license such as MIT?

As detailed in our original justification we believe that a weak copyleft license, i.e. the Lesser GNU GPL licenses, best respects the original intent of historical contributions to MDAnalysis. Additionally, we are also aware of various portions of the MDAnalysis library which likely have derivative code from other LGPL v2.1+ licensed codes, such as GROMACS. We do not believe it to be possible at this point to remove these portions of the library without significantly impacting the user experience.

Detailing our proposed relicensing process

Table 2. A stepwise description of the proposed MDAnalysis relicensing process.

Step Package License Source Code License from Historical Contributions Source Code License from New Contributions Details & Conditions of Change MDAnalysis Versions
1. GPL v2+ GPL v2+ GPL v2+ This is the initial state of the MDAnalysis library license. < v2.6.0
2. GPL v3+ GPL v2+ LGPL v2.1+ As of commit 44733fc all new contributions are made under LGPL v2.1+ v2.6.0+
3. LGPL v3+ LGPL v2.1+ LGPL v2.1+ Once historical contributors have agreed to relicense their contributions. N/A
4. LGPL v2.1+ LGPL v2.1+ LGPL v2.1+ Once Apache 2.0 dependencies have been removed from the library. N/A

In this section, we will briefly go over the various steps we propose to take (Table 2) as we go about relicensing the MDAnalysis core library.

1. A GPL v2+ package and source code (MDAnalysis v2.5 and lower)

This is the original state of the license up until the 2.5.x releases of MDAnalysis. The package and source code were released under a GPL v2+ license.

2. A GPL v3+ package, and a mix of historical GPL v2+ and new LGPL v2.1+ source code (MDAnalysis v2.6 onwards)

As of commit 44733fc, all new contributions to MDAnalysis have been made under the terms of the LGPL v2.1+ and the package is released under GPL v3+ to better reflect our understanding of the Apache 2.0 incompatibility issues. Historical source code contributions remain under the terms of GPL v2+.

This will remain the state of MDAnalysis until we obtain approval from our developers to relicense their code to LGPL v2.1+. As we obtain contributor agreements, these historical source code contributions will slowly turn to LGPL v2.1+.

3. An LGPL v3+ package, and an LGPL v2.1+ source code (Optional)

Should we obtain approval to relicense from our developers before we remove our Apache 2.0 dependencies, we will then start releasing the MDAnalysis package under a LGPL v3+ license.

4. An LGPL v2.1+ package and source code

This is the state which we aim for the library to eventually be licensed under. Once we both obtain the agreement of our developers to relicense and remove Apache 2.0 dependencies, we will be able to release the MDAnalysis package under LGPL v2.1+.

How does this affect me?

As a contributor

If you have any historical contributions you will be asked to relicense them to LGPL v2.1+ instead of the initially proposed LGPL v3+.

As a developer

Ultimately we believe that the proposed change to LGPL v2.1+ should offer a better compatibility (Table 1) with whatever license you may choose to use for your own code. The interim package license changes may however impact you, if you believe this to be the case please do get in touch with us.

As a user

We do not anticipate this to have a significant impact on users. There may be some slight changes to how you might access MMTF files which are discussed below.

Next steps

Contacting contributors

We will shortly be contacting every historical contributor to MDAnalysis and ask them to agree to changing their contribution’s license from the current “GPL v2 or any later version” to “LGPL v2.1 or any later version”.

Specifically we will be asking all contributors to respond with the following statement:

I, <your name>, GitHub handle <your GitHub handle>, am the copyright owner of all the code I submitted
to the MDAnalysis library using my GitHub handle. I agree to relicense all my code contributions to the
MDAnalysis library under the LGPLv2.1+ license from this day going forward.

Typed Signature

Please note that it is important to ensure that the responding party is the copyright owner. In some cases, your University or Employer, at the time of contribution, may have been the copyright owner instead of yourself. If you think this might be the case, please let us know as soon as possible with any relevant information as to whom the copyright owner might be.

It is important that we hear back from as many contributors as possible. If you have contributed to MDAnalysis in the past but have since changed your git-linked contact details, we would kindly ask if you could email [email protected] to let us know how best to contact you.

Removing Apache 2.0 dependencies

As we move towards a v3.0 release of MDAnalysis, we will be looking to replace existing Apache 2.0 core dependencies. Of particular impact, this may mean that access to reading MMTF files may no longer be available by default through the MDAnalysis library, but will instead be offered through an optionally installable MDAKit.

Getting in touch

We understand that license changes are a complex subject that can have a large impact on how users and developers may interact with the MDAnalysis library. Should you have any concerns, questions, or comments, we urge you to get in touch with the core developer team. You can do so over our public forums or privately by emailing [email protected].


package license

The license under which the MDAnalysis library is packaged and released. This may be different from but still compatible with the source code license.

source code license

The license under which the MDAnalysis source code is released. This only accounts for the code itself and not any impact in licensing incurred from linking (i.e. python importing) to other libraries.

license compatibility

Whether or not the terms of two licenses allows them to be compatible with each other.


Whether the terms of a given license enforces that other codes (even under other licenses) must be bound by the same conditions. See the FSF definition for more information.


We are very grateful for the administrative and legal support from our fiscal sponsor, NumFOCUS.

This relicensing effort has been made possible in part by the CZI grant DAF2021-237663, grant DOI from the Chan Zuckerberg Initiative DAF, an advised fund of Silicon Valley Community Foundation (funder DOI 10.13039/100014989).

– Irfan Alibay on behalf of the MDAnalysis Core Developers

Release 2.6.0 and 2.6.1 of MDAnalysis

We are happy to release version 2.6.1 of MDAnalysis! (This blog post describes 2.6.1 and the initial release in the 2.6 series, 2.6.0.)

This is a minor update to the MDAnalysis library.

This release of MDAnalysis is packaged under a GPLv3+ license. Additionally all contributions made from commit 44733fc onwards are made under the LGPLv2.1+ license. More details about these license changes will be provided in an upcoming blog post.

In line with NEP 29, the minimum required NumPy version has been raised to 1.22.3.

Supported Python versions: 3.9, 3.10, 3.11

Supported Operating Systems:

Upgrading to MDAnalysis version 2.6.1

To update with conda from the conda-forge channel run

conda update -c conda-forge mdanalysis

To update from PyPi with pip run

python -m pip install --upgrade MDAnalysis

For more help with installation see the installation instructions in the User Guide. Make sure you are using a Python version compatible with MDAnalysis before upgrading (Python >= 3.9).

Notable changes

For a full list of changes, bugfixes and deprecations see the CHANGELOG.


  • Fix to element guessing code to more accurately interpret atom names split by numbers (i.e. N0A is now recognised as N rather than NA) [Issue #4167, PR #4168]
  • The -ffast-math compiler flag is no longer used by default at build time, avoiding inconsistent (although still scientifically correct) results seen in Intel MacOS systems when calling AtomGroup.center_of_charge(..., unwrap=True). This also avoids potentially incorrect floating point results. (PR #4220)
  • DATAWriter, CRD, PQR, and PDBQT files can now be correctly written to compressed files. Before this change, any attempt to write to a compressed format (gzip or bzip2) would lead to writing out an uncompressed file. (PR #4163)
  • Prevent accidental merging of bond/angle/dihedral types when they are defined as LAMMPS style string integers instead of tuples. This was leading to an incorrect number of bond/angle/dihedral types being written to lammps data files. (PR #4003)


  • An exclude_same argument has been added to InterRDF allowing pairs of atoms that share the same residue, segment or chain to be excluded from the calculation. (PR #4161)
  • LAMMPS reader now supports the continuous ChainReader option. (PR #4170)
  • AtomGroup representation now returns atom indices in the same order as they are stored in the AtomGroup. (PR #4191)


  • As per NEP29, the minimum supported runtime version of NumPy has been increased to 1.22.3. (PR #4160)
  • The GSD package is now an optional dependency. (PR #4174)
  • The MDAnalysis package now only supports GSD versions 3.0.1 or above. (PR #4153)
  • MDAnalysis no longer officially supports 32 bit installations, (they are no longer tested in our continuous integration pipelines). Note: no code changes have been made to disable 32 bit, although it is known that new versions of most MDAnalysis core dependencies no longer release 32 bit compatible versions. (PR #4176)
  • The package license has been updated to GPLv3+ to better reflect the compatibility of GPLv2+ with Apache and GPLv3 licensed codes. Additionally all new contributions from commit 44733fc onwards are made under the LGPLv2.1+ license. (PR #4219)


  • The misspelt Boltzman_constant entry in MDAnalysis.units is now deprecated in favour the correctly spelt Boltzmann_constant. (PRs #4230 and #4214)
  • MDAnalysis.analysis.hole2 is now deprecated in favour of a new HOLE2 MDAKit. (PR #4200)

Author statistics

This release was the work of 10 contributors, 4 of which are new contributors.

Our new contributors are:

@MohitKumar020291 @Shubx10 @ztimol @pillose


MDAnalysis thanks NumFOCUS for its continued support as our fiscal sponsor and the Chan Zuckerberg Initiative for supporting MDAnalysis under EOSS4 and EOSS5 awards.

— The MDAnalysis Team