Coarse-grained simulations with the SAFT-gamma Mie force field
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.
pip install raasaft # or to upgrade pip install --upgrade raasaft # To start using raaSAFT: mkdir raasaft && cd raasaft raasaft_init # You now have the helpful directories tutorials/ replication/ and mysaft/ ls # 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 http://bitbucket.org/asmunder/raasaft
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.:
Contributions to raaSAFT with new models are always welcome, assuming the model has seen at least some level of validation.
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 firstname.lastname@example.org
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for raaSAFT-0.6.4-py2.py3-none-any.whl