Installation

try pytraj online:

Note

For Linux user, we highly recommend install pytraj via conda

Requires

  • python 2.7, >=3.4

  • cython, >= 0.23. Cython is only required if installing development version:

    pip install cython --upgrade
    
    # conda install cython
    
  • numpy

Install

from conda (Linux, OX)

We higly recommend install pytraj by conda

conda install -c ambermd pytraj-dev

This takes only less than 30 seconds.

If you don’t want to read long description about installing conda, just copy and paste below script to your terminal (for Linux). For Mac user, you need to follow conda website.

$ wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh
$ sh Miniconda3-latest-Linux-x86_64.sh

from pip (Linux, OSX)

Note:

  • Recommend to use python >= 3.4, pip >= 8.1
  • osx: no wheel for python 2.7
pip install pytraj

from source code (easy way: Linux, OSX)

git clone https://github.com/Amber-MD/pytraj
cd pytraj

# linux
python ./setup.py install

# osx:
python setup.py install --disable-openmp

# note: pytraj will automatically install cpptraj first.

Depend on your machine, the fresh installation (libcpptraj + pytraj) could take 2 to 4 minutes.

from source code (hard way - expert only)

Sometimes you want to install libcpptraj.so by yourself.

  • First, download cpptraj:

    git clone https://github.com/Amber-MD/cpptraj
    cd cpptraj
    bash configure -shared -openmp gnu
    
    # if you are AMBER user, you can add -amberlib
    bash configure -shared -openmp -amberlib gnu
    make libcpptraj -j4
    
    # please check bash configure --full-help for other options.
    # check: https://github.com/Amber-MD/cpptraj too
    export CPPTRAJHOME=`pwd`
    
  • Then, install pytraj

    # cd to any folder you want to store pytraj code
    # then
    git clone https://github.com/Amber-MD/pytraj
    cd pytraj
    python ./setup.py install
    

from AMBER distribution (Linux, OSX)

pytraj is included in AMBER16, which will be released soon (2016): ambermd.org

Update pytraj

Rule of thumb: using the same tool to install/update (upgrade)

from conda

If you install pytraj by conda, you can update it easily

conda update -c ambermd pytraj-dev libcpptraj-dev --force

from pip

pip install --upgrade pytraj

from github

if you install from source code and want to update the development code in github, try to follow below.

$ # make sure to go to pytraj folder (which has README.md, ./tests ...)
$ git pull
$ python ./setup.py install

if you install pytraj via github and want to update cpptraj

$ cd cpptraj
$ git pull
$ make libcpptraj

Uninstall

Rule of thumb: using the same tool to install/uninstall

from conda

$ conda remove pytraj-dev libcpptraj-dev

from pip

$ pip uninstall pytraj

Troubleshooting

Permission denied

python setup.py install is standard process to install a new Python package. But if you are new to Python and got permission denied error, try to install pytraj in your home folder.

# install pytraj in $HOME/.local
python ./setup.py install --user

# or install pytraj in ``your_favorite_dir``
python ./setup.py install --prefix=your_favorite_dir
# if you do this, make sure to add ``your_favorite_dir`` to $PYTHONPATH
export PYTHONPATH=your_favorite_dir:$PYTHONPATH

If you want to see further options, check python setup.py install --help

Image not found (OSX)

Please try to install from conda or from AMBER distribution or from source code. No pip yet please.

install ipython and its notebook for interactive data exploration

ipython and its notebook is great program for interactive exloration of MD data. Curious about how the notebook looks like? check out our pairwise rmsd tutorial

If you are using anaconda, just type ipython notebook. If you have not haved ipython and its notebook, try conda install ipython For further instruction and information about ipython-notebook, please check its website.

install anaconda for all python packages

we highly recommend to install anaconda that has all good python packages (cython, numpy, sklearn, pandas, ...). Anaconda is totally free.

  • go to its website, choose your platform and python version. It’s better to pick up Python3
  • download file: For example, we downloaded Anaconda3-2.1.0-Linux-x86_64.sh (Python3 version)
  • just run bash Anaconda3-2.1.0-Linux-x86_64.sh and follow instruction. That’s it, you have a Python eco-system here.

install and run jupyter noteook

# install
conda install notebook

# run
jupyter notebook

# or run
jupyter notebook {your_notebook_name}.ipynb

If you want to run Jupyter notebook remotely, check Use Jupyter notebook remotely