Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Coarse-grained simulations with the SAFT-gamma Mie force field

Project Description
  • raaSAFT (pronounced “raw saft”) is a Python framework that makes it easy to set up coarse-grained molecular dynamics simulations.
  • raaSAFT runs with HOOMD-blue as a backend, so you can use GPU power. Initial support for using GROMACS has been added.
  • raaSAFT uses the SAFT-gamma Mie force field, a powerful coarse-graining method that gives accuracy comparable to atomistic models, with runtimes that are orders of magnitude shorter.
  • Raasaft is a Norwegian word meaning “pure fruit syrup”. Apart from the obvious saft <-> SAFT pun, “raa” means crude/raw/coarse, so it is twice as punny.



  • raaSAFT uses HOOMD-blue, see the HOOMD-blue install guide.
  • For now this is a dependency even if you want to run with GROMACS. The non-GPU version of HOOMD-blue is sufficient.
  • Note that HOOMD-blue runs on Linux or Mac OSX. Windows is not supported.

Simple installation:

pip install raasaft

# or to upgrade
pip install --upgrade raasaft

# To start using raaSAFT:
mkdir raasaft && cd raasaft
# You now have the helpful directories tutorials/ replication/ and mysaft/

# Read the "Running simulations" section below.

Installation for advanced users / contributors:

  • Install dependencies. This includes HOOMD-blue and the Python packages future and requests.
  • Clone the repo at
    • The maint branch should be as stable as the version on PyPi
    • The master branch changes frequently and may not always be stable
  • You probably want to add the repo directory to your PYTHONPATH.

Running simulations with raaSAFT

  • Look at the README.txt file in raasaft/tutorials/ for examples of how to use raaSAFT.
  • In raasaft/replication/ we include setups that can be used to replicate the findings of various papers.
  • In raasaft/mysaft/ you find an example of how to add your own models for new molecules.
    • You can use these user-defined models with e.g.
from mysaft.example import Example
ex = Example(count=1e3)
  • If you want to use these models in jobscripts in different directories, add the full path to the raasaft folder to your PYTHONPATH shell variable (put this in your .bashrc file to make it permanent), e.g.:
    export PYTHONPATH=$PYTHONPATH:”/path/to/raasaft”
  • Contributions to raaSAFT with new models are always welcome, assuming the model has seen at least some level of validation.

Bottled SAFT

You can get models (force field parameters) for 6000+ molecules from our database called Bottled SAFT:

This web application provides scripts that implement the search result in raaSAFT for you!


The code is Free and Open Source software under the MIT license.


All contributions are welcome!


Email Aasmund at

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
raaSAFT-0.6.4-py2.py3-none-any.whl (30.8 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Jan 21, 2016
raaSAFT-0.6.4.tar.gz (139.1 kB) Copy SHA256 Checksum SHA256 Source Jan 21, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting