From 89c9321a780f5aef7b7284c52e51c93febfcbcc6 Mon Sep 17 00:00:00 2001 From: Jamie Rowe Date: Wed, 18 Nov 2026 13:40:22 +0000 Subject: [PATCH 1/3] Added code of conduct and numfocus --- README.rst | 29 ++++++++++++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 6b1a721a..1ce3ceba 100644 --- a/README.rst +++ b/README.rst @@ -6,12 +6,28 @@ |usergroup| |developergroup| -MDAnalysis is a Python toolkit to analyse molecular dynamics files and trajectories in `many popular formats`_. MDAnalysis can write most of these formats, too, together with atom selections for use in visualisation tools or other analysis programs. It provides a fast framework for complex analysis tasks, as well as flexible tooling to construct your own analyses. +MDAnalysis_ is a Python toolkit to analyse molecular dynamics files and trajectories in `many popular formats`_. MDAnalysis can write most of these formats, too, together with atom selections for use in visualisation tools or other analysis programs. It provides a fast framework for complex analysis tasks, as well as flexible tooling to construct your own analyses. This repository contains the `user guide`_ for MDAnalysis. The user guide originated as a `project for Google Season of Docs 2019-2020`_. The code in the user guide is released under the `GNU LGPL v2.1+` license, while text and images are released under the `CC BY-SA 4.0 DEED`_ license. +.. _numfocus-fiscal-sponsor-attribution: + +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. + +.. image:: https://www.mdanalysis.org/public/images/numfocus-sponsored-small.png + :alt: NumFOCUS (Fiscally Sponsored Project) + :target: https://numfocus.org/project/mdanalysis + :align: center + +This project is bound by a `Code of Conduct`_. + +|powered_by_MDA| + +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. + .. Footnotes .. _`CC BY-SA 4.0 DEED`: https://creativecommons.org/licenses/by-sa/4.0/ @@ -21,6 +37,10 @@ The code in the user guide is released under the `GNU LGPL v2.1+` license, while .. _MDAnalysis: https://www.mdanalysis.org .. _LICENSE: https://github.com/MDAnalysis/mdanalysis/blob/develop/LICENSE .. _`project for Google Season of Docs 2019-2020`: https://developers.google.com/season-of-docs/docs/2019/participants/project-mdanalysis +.. _NumFOCUS: https://numfocus.org/ +.. _open governance model: https://www.mdanalysis.org/pages/governance/ +.. _tax-deductible donation: https://numfocus.org/donate-to-mdanalysis +.. _`Code of Conduct`: https://www.mdanalysis.org/conduct/ .. |usergroup| image:: https://img.shields.io/badge/Google%20Group-Users-lightgrey.svg :alt: User Google Group @@ -37,3 +57,10 @@ The code in the user guide is released under the `GNU LGPL v2.1+` license, while .. |binder| image:: https://mybinder.org/badge_logo.svg :alt: Binder :target: https://mybinder.org/v2/gh/MDAnalysis/binder-env-userguide/main?urlpath=git-pull%3Frepo%3Dhttps%253A%252F%252Fgithub.com%252FMDAnalysis%252FUserGuide%26urlpath%3Dtree%252FUserGuide%252Fdoc%252Fsource%252Fexamples%26branch%3Dmaster + +.. _Embedding code: https://www.mdanalysis.org/pages/citations/#powered-by-mdanalysis + +.. |powered_by_MDA| image:: https://img.shields.io/badge/Powered%20by-MDAnalysis-orange.svg?logoWidth=15&logo=data:image/x-icon;base64,AAABAAEAEBAAAAEAIAAoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJD+XwCY/fEAkf3uAJf97wGT/a+HfHaoiIWE7n9/f+6Hh4fvgICAjwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACT/yYAlP//AJ///wCg//8JjvOchXly1oaGhv+Ghob/j4+P/39/f3IAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJH8aQCY/8wAkv2kfY+elJ6al/yVlZX7iIiI8H9/f7h/f38UAAAAAAAAAAAAAAAAAAAAAAAAAAB/f38egYF/noqAebF8gYaagnx3oFpUUtZpaWr/WFhY8zo6OmT///8BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgICAn46Ojv+Hh4b/jouJ/4iGhfcAAADnAAAA/wAAAP8AAADIAAAAAwCj/zIAnf2VAJD/PAAAAAAAAAAAAAAAAICAgNGHh4f/gICA/4SEhP+Xl5f/AwMD/wAAAP8AAAD/AAAA/wAAAB8Aov9/ALr//wCS/Z0AAAAAAAAAAAAAAACBgYGOjo6O/4mJif+Pj4//iYmJ/wAAAOAAAAD+AAAA/wAAAP8AAABhAP7+FgCi/38Axf4fAAAAAAAAAAAAAAAAiIiID4GBgYKCgoKogoB+fYSEgZhgYGDZXl5e/m9vb/9ISEjpEBAQxw8AAFQAAAAAAAAANQAAADcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAjo6Mb5iYmP+cnJz/jY2N95CQkO4pKSn/AAAA7gAAAP0AAAD7AAAAhgAAAAEAAAAAAAAAAACL/gsAkv2uAJX/QQAAAAB9fX3egoKC/4CAgP+NjY3/c3Nz+wAAAP8AAAD/AAAA/wAAAPUAAAAcAAAAAAAAAAAAnP4NAJL9rgCR/0YAAAAAfX19w4ODg/98fHz/i4uL/4qKivwAAAD/AAAA/wAAAP8AAAD1AAAAGwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALGxsVyqqqr/mpqa/6mpqf9KSUn/AAAA5QAAAPkAAAD5AAAAhQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADkUFBSuZ2dn/3V1df8uLi7bAAAATgBGfyQAAAA2AAAAMwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB0AAADoAAAA/wAAAP8AAAD/AAAAWgC3/2AAnv3eAJ/+dgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA9AAAA/wAAAP8AAAD/AAAA/wAKDzEAnP3WAKn//wCS/OgAf/8MAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIQAAANwAAADtAAAA7QAAAMAAABUMAJn9gwCe/e0Aj/2LAP//AQAAAAAAAAAA + :alt: Powered by MDAnalysis + :target: https://www.mdanalysis.org + From 70f6fd052a45626e72afd79cb560491a54149031 Mon Sep 17 00:00:00 2001 From: Jamie Rowe Date: Wed, 18 Nov 2026 13:50:20 +0000 Subject: [PATCH 2/3] Removed old banners --- README.rst | 16 +--------------- 1 file changed, 1 insertion(+), 15 deletions(-) diff --git a/README.rst b/README.rst index 1ce3ceba..eaa2361f 100644 --- a/README.rst +++ b/README.rst @@ -2,9 +2,7 @@ MDAnalysis User Guide ================================ -|build| |binder| - -|usergroup| |developergroup| +|build| MDAnalysis_ is a Python toolkit to analyse molecular dynamics files and trajectories in `many popular formats`_. MDAnalysis can write most of these formats, too, together with atom selections for use in visualisation tools or other analysis programs. It provides a fast framework for complex analysis tasks, as well as flexible tooling to construct your own analyses. @@ -42,22 +40,10 @@ If you use MDAnalysis_ in your project consider letting your users and the world .. _tax-deductible donation: https://numfocus.org/donate-to-mdanalysis .. _`Code of Conduct`: https://www.mdanalysis.org/conduct/ -.. |usergroup| image:: https://img.shields.io/badge/Google%20Group-Users-lightgrey.svg - :alt: User Google Group - :target: http://users.mdanalysis.org - -.. |developergroup| image:: https://img.shields.io/badge/Google%20Group-Developers-lightgrey.svg - :alt: Developer Google Group - :target: http://developers.mdanalysis.org - .. |build| image:: https://github.com/MDAnalysis/UserGuide/actions/workflows/gh-ci.yaml/badge.svg :alt: Build Status :target: https://github.com/MDAnalysis/UserGuide/actions/workflows/gh-ci.yaml -.. |binder| image:: https://mybinder.org/badge_logo.svg - :alt: Binder - :target: https://mybinder.org/v2/gh/MDAnalysis/binder-env-userguide/main?urlpath=git-pull%3Frepo%3Dhttps%253A%252F%252Fgithub.com%252FMDAnalysis%252FUserGuide%26urlpath%3Dtree%252FUserGuide%252Fdoc%252Fsource%252Fexamples%26branch%3Dmaster - .. _Embedding code: https://www.mdanalysis.org/pages/citations/#powered-by-mdanalysis .. |powered_by_MDA| image:: https://img.shields.io/badge/Powered%20by-MDAnalysis-orange.svg?logoWidth=15&logo=data:image/x-icon;base64,AAABAAEAEBAAAAEAIAAoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJD+XwCY/fEAkf3uAJf97wGT/a+HfHaoiIWE7n9/f+6Hh4fvgICAjwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACT/yYAlP//AJ///wCg//8JjvOchXly1oaGhv+Ghob/j4+P/39/f3IAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJH8aQCY/8wAkv2kfY+elJ6al/yVlZX7iIiI8H9/f7h/f38UAAAAAAAAAAAAAAAAAAAAAAAAAAB/f38egYF/noqAebF8gYaagnx3oFpUUtZpaWr/WFhY8zo6OmT///8BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgICAn46Ojv+Hh4b/jouJ/4iGhfcAAADnAAAA/wAAAP8AAADIAAAAAwCj/zIAnf2VAJD/PAAAAAAAAAAAAAAAAICAgNGHh4f/gICA/4SEhP+Xl5f/AwMD/wAAAP8AAAD/AAAA/wAAAB8Aov9/ALr//wCS/Z0AAAAAAAAAAAAAAACBgYGOjo6O/4mJif+Pj4//iYmJ/wAAAOAAAAD+AAAA/wAAAP8AAABhAP7+FgCi/38Axf4fAAAAAAAAAAAAAAAAiIiID4GBgYKCgoKogoB+fYSEgZhgYGDZXl5e/m9vb/9ISEjpEBAQxw8AAFQAAAAAAAAANQAAADcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAjo6Mb5iYmP+cnJz/jY2N95CQkO4pKSn/AAAA7gAAAP0AAAD7AAAAhgAAAAEAAAAAAAAAAACL/gsAkv2uAJX/QQAAAAB9fX3egoKC/4CAgP+NjY3/c3Nz+wAAAP8AAAD/AAAA/wAAAPUAAAAcAAAAAAAAAAAAnP4NAJL9rgCR/0YAAAAAfX19w4ODg/98fHz/i4uL/4qKivwAAAD/AAAA/wAAAP8AAAD1AAAAGwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALGxsVyqqqr/mpqa/6mpqf9KSUn/AAAA5QAAAPkAAAD5AAAAhQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADkUFBSuZ2dn/3V1df8uLi7bAAAATgBGfyQAAAA2AAAAMwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB0AAADoAAAA/wAAAP8AAAD/AAAAWgC3/2AAnv3eAJ/+dgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA9AAAA/wAAAP8AAAD/AAAA/wAKDzEAnP3WAKn//wCS/OgAf/8MAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIQAAANwAAADtAAAA7QAAAMAAABUMAJn9gwCe/e0Aj/2LAP//AQAAAAAAAAAA From 2cdbb43a6707dc3c42b4f41bc098fca99ec8afc9 Mon Sep 17 00:00:00 2001 From: Jamie Rowe Date: Wed, 18 Nov 2026 14:23:48 +0000 Subject: [PATCH 3/3] Add citations and contributing section. Unite description with main library --- README.rst | 47 +++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 41 insertions(+), 6 deletions(-) diff --git a/README.rst b/README.rst index eaa2361f..b515dee8 100644 --- a/README.rst +++ b/README.rst @@ -4,15 +4,18 @@ |build| -MDAnalysis_ is a Python toolkit to analyse molecular dynamics files and trajectories in `many popular formats`_. MDAnalysis can write most of these formats, too, together with atom selections for use in visualisation tools or other analysis programs. It provides a fast framework for complex analysis tasks, as well as flexible tooling to construct your own analyses. + +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`_. This repository contains the `user guide`_ for MDAnalysis. The user guide originated as a `project for Google Season of Docs 2019-2020`_. -The code in the user guide is released under the `GNU LGPL v2.1+` license, while text and images are released under the `CC BY-SA 4.0 DEED`_ license. +The code in the user guide is released under the `GNU LGPL v2.1+`_ license, while text and images are released under the `CC BY-SA 4.0 DEED`_ license. .. _numfocus-fiscal-sponsor-attribution: -The MDAnalysis project uses an `open governance model`_ and is fiscally sponsored by `NumFOCUS`_. Consider making +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. .. image:: https://www.mdanalysis.org/public/images/numfocus-sponsored-small.png @@ -26,6 +29,33 @@ 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. +Contributing +============ + +If you would like to contribute documentation to the `user guide`_, please follow the instructions in the `contributing to the user guide`_ page. All contributions must comply with the MDAnalysis `AI policy`_. + + +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_. + .. Footnotes .. _`CC BY-SA 4.0 DEED`: https://creativecommons.org/licenses/by-sa/4.0/ @@ -39,14 +69,19 @@ If you use MDAnalysis_ in your project consider letting your users and the world .. _open governance model: https://www.mdanalysis.org/pages/governance/ .. _tax-deductible donation: https://numfocus.org/donate-to-mdanalysis .. _`Code of Conduct`: https://www.mdanalysis.org/conduct/ +.. _trajectory formats: https://docs.mdanalysis.org/documentation_pages/coordinates/init.html#id1 +.. _topology formats: https://docs.mdanalysis.org/documentation_pages/topology/init.html#supported-topology-formats +.. _`AI policy`: https://github.com/MDAnalysis/mdanalysis/blob/develop/AI_POLICY.md +.. _`contributing to the user guide`: https://userguide.mdanalysis.org/stable/contributing_docs.html +.. _`10.1002/jcc.21787`: https://dx.doi.org/10.1002/jcc.21787 +.. _`10.25080/Majora-629e541a-00e`: https://doi.org/10.25080/Majora-629e541a-00e +.. _references: https://docs.mdanalysis.org/documentation_pages/references.html +.. _Embedding code: https://www.mdanalysis.org/pages/citations/#powered-by-mdanalysis .. |build| image:: https://github.com/MDAnalysis/UserGuide/actions/workflows/gh-ci.yaml/badge.svg :alt: Build Status :target: https://github.com/MDAnalysis/UserGuide/actions/workflows/gh-ci.yaml -.. _Embedding code: https://www.mdanalysis.org/pages/citations/#powered-by-mdanalysis - .. |powered_by_MDA| image:: https://img.shields.io/badge/Powered%20by-MDAnalysis-orange.svg?logoWidth=15&logo=data:image/x-icon;base64,AAABAAEAEBAAAAEAIAAoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJD+XwCY/fEAkf3uAJf97wGT/a+HfHaoiIWE7n9/f+6Hh4fvgICAjwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACT/yYAlP//AJ///wCg//8JjvOchXly1oaGhv+Ghob/j4+P/39/f3IAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJH8aQCY/8wAkv2kfY+elJ6al/yVlZX7iIiI8H9/f7h/f38UAAAAAAAAAAAAAAAAAAAAAAAAAAB/f38egYF/noqAebF8gYaagnx3oFpUUtZpaWr/WFhY8zo6OmT///8BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgICAn46Ojv+Hh4b/jouJ/4iGhfcAAADnAAAA/wAAAP8AAADIAAAAAwCj/zIAnf2VAJD/PAAAAAAAAAAAAAAAAICAgNGHh4f/gICA/4SEhP+Xl5f/AwMD/wAAAP8AAAD/AAAA/wAAAB8Aov9/ALr//wCS/Z0AAAAAAAAAAAAAAACBgYGOjo6O/4mJif+Pj4//iYmJ/wAAAOAAAAD+AAAA/wAAAP8AAABhAP7+FgCi/38Axf4fAAAAAAAAAAAAAAAAiIiID4GBgYKCgoKogoB+fYSEgZhgYGDZXl5e/m9vb/9ISEjpEBAQxw8AAFQAAAAAAAAANQAAADcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAjo6Mb5iYmP+cnJz/jY2N95CQkO4pKSn/AAAA7gAAAP0AAAD7AAAAhgAAAAEAAAAAAAAAAACL/gsAkv2uAJX/QQAAAAB9fX3egoKC/4CAgP+NjY3/c3Nz+wAAAP8AAAD/AAAA/wAAAPUAAAAcAAAAAAAAAAAAnP4NAJL9rgCR/0YAAAAAfX19w4ODg/98fHz/i4uL/4qKivwAAAD/AAAA/wAAAP8AAAD1AAAAGwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALGxsVyqqqr/mpqa/6mpqf9KSUn/AAAA5QAAAPkAAAD5AAAAhQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADkUFBSuZ2dn/3V1df8uLi7bAAAATgBGfyQAAAA2AAAAMwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB0AAADoAAAA/wAAAP8AAAD/AAAAWgC3/2AAnv3eAJ/+dgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA9AAAA/wAAAP8AAAD/AAAA/wAKDzEAnP3WAKn//wCS/OgAf/8MAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIQAAANwAAADtAAAA7QAAAMAAABUMAJn9gwCe/e0Aj/2LAP//AQAAAAAAAAAA :alt: Powered by MDAnalysis :target: https://www.mdanalysis.org -