1. Quick installation instructions for MDPOW¶
MDPOW is compatible with Python 2.7 and 3.7+ and tested on Ubuntu and Mac OS. Python 2.7 is rock-stable and frozen but not officially supported anymore by the Python developers.
We recommend that you install MDPOW in a virtual environment.
1.1. Installation for users¶
Most users should follow these instructions.
We use the Anaconda distribution with the conda
command to manage
dependencies (see installing the Anaconda distribution for details on how to
set up conda
).
To run MDPOW you will also need to install a compatible version of GROMACS.
1.1.1. Conda environment with pre-requisites¶
To make a conda environment with the latest packages for Python 2.7 and name it mdpow; this installs the larger dependencies that are pre-requisites for MDPOW:
conda create -c conda-forge -n mdpow python=2.7 numpy scipy 'matplotlib<3.3' 'mdanalysis<2' 'mdanalysistests<2' pyyaml six
conda activate mdpow
pip install gromacswrapper
For Python 3.7 and up.
Note: with Pandas version 1.3 there is an error with Alchemlyb (see issue #147) which will be fixed in Alchemlyb 0.5.:
conda create -c conda-forge -n mdpow python=3.7 numpy scipy 'matplotlib' 'mdanalysis' 'mdanalysistests' pyyaml six
conda activate mdpow
pip install gromacswrapper
1.1.2. Installation from source¶
Install from source:
conda activate mdpow
git clone https://github.com/Becksteinlab/MDPOW.git
pip install ./MDPOW
(Older releases are available but outdated; use the latest source for now.)
1.1.3. Checking that the installation worked¶
Check that you can run the mdpow-*
commandline tools:
mdpow-equilibrium --help
should print a whole bunch of messages. If your GROMACS installation
cannot be found, make sure you source GMXRC
or load the appopriate
modules or whatever else you have to do so that the gmx
command is
found. See https://gromacswrapper.readthedocs.io for more details.
Check that you can import the module:
python
>>> import mdpow
>>> help(mdpow)
In case of problems file an issue at https://github.com/Becksteinlab/MDPOW/issues
1.2. Developer installation¶
A development install is useful while hacking away on the code:
cd MDPOW
pip install -e .