/
index.txt
144 lines (100 loc) · 4.36 KB
/
index.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
.. -*- coding: utf-8 -*-
.. GromacsWrapper documentation master file, created by sphinx-quickstart on Tue Jun 23 19:38:56 2009.
====================================================
GromacsWrapper --- a Python framework for GROMACS
====================================================
:Release: |release|
:Date: |today|
**GromacsWrapper** is a pure Python package that wraps system calls to
GROMACS_ tools into thin classes. This allows for fairly seamless
integration of the GROMACS tools into Python_ scripts. This is
generally superior to shell scripts because of Python's better error
handling and superior data structures. It also allows for
modularization and code re-use. In addition, commands, warnings and
errors are logged to a file so that there exists a complete history of
what has been done.
GROMACS_ versions 4.6.x, 2016.x, 2018.x, 2019.x, 2020.x, 2021.x,
2022.x, and 2023.x are all supported. GromacsWrapper detects your
Gromacs tools and provides them as :func:`gromacs.grompp`,
:func:`gromacs.mdrun`, etc, regardless of your Gromacs version, which
allows one to write scripts that are broadly Gromacs-version
agnostic. Source your ``GMXRC`` file or make the :program:`gmx` binary
(for versions ≥ 5.x) or all the GROMACS tools available on your
:envvar:`PATH` for GromacsWrapper to find the GROMACS installation.
.. warning::
Although GromacsWrapper has been used in published research over the
last 10 years or so, there is no guarantee that any of the defaults
chosen are suitable for any particular project or simulation setup.
It is **your responsibility to ensure that you are running
simulations with sensible parameters.** Provide appropriate template
files instead of the bundled defaults and check the logger output!
Please report bugs in the `issue tracker`_ and go to the
`discussions`_ forum for questions.
Contributions are very welcome --- start by raising an issue in the
`issue tracker`_ to describe what feature you're adding or what bug
you're fixing.
.. SeeAlso:: Other approaches to interfacing Python_ and GROMACS_
are listed under :doc:`alternatives`.
Getting started
===============
See :ref:`installation` for supported versions of Python and download
and installation instructions. The :ref:`quickstart` provides a brief
example of how to use GromacsWrapper in the most basic fashion.
The source code itself is available in the `GromacsWrapper git
repository`_.
You also need to have a version of GROMACS_ installed.
.. _GROMACS: http://www.gromacs.org
.. _Python: https://www.python.org
.. _Documentation: https://gromacswrapper.readthedocs.io/
.. _GromacsWrapper git repository:
https://github.com/Becksteinlab/GromacsWrapper
.. _issue tracker:
https://github.com/Becksteinlab/GromacsWrapper/issues
.. _discussions:
https://github.com/Becksteinlab/GromacsWrapper/discussions
License
=======
The **GromacsWrapper** package is made available under the terms of
the `GNU Public License v3`_ (or any higher version at your choice)
except as noted below. See the file COPYING for the licensing terms
for all modules.
.. _GNU Public License v3: http://www.gnu.org/licenses/gpl.html
Citing
======
|zenodo|
GromacsWrapper was written by Oliver Beckstein with contributions from
many other people. Please see the file AUTHORS_ for all the names.
If you find this package useful and use it in published work I'd be
grateful if it was acknowledged in text as
"... used GromacsWrapper (Oliver Beckstein et al,
https://github.com/Becksteinlab/GromacsWrapper doi: 10.5281/zenodo.17901)"
or in the Acknowledgements section.
Thank you.
.. _AUTHORS:
https://raw.githubusercontent.com/Becksteinlab/GromacsWrapper/main/AUTHORS
.. |zenodo| image:: https://zenodo.org/badge/13219/Becksteinlab/GromacsWrapper.svg
:target: https://zenodo.org/badge/latestdoi/13219/Becksteinlab/GromacsWrapper
:alt: Latest release on zenodo (with DOI)
Contact
=======
Please use the `issue tracker`_ to report bugs, installation problems,
and feature requests (mention ``@orbeckst`` in the issue report) and
use the `discussions`_ forum for general questions.
.. Contents
.. --------
.. toctree::
:numbered:
:maxdepth: 2
:hidden:
installation
quickstart
overview
configuration
gromacs
alternatives
..
Indices and tables
------------------
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`