Skip to content

leeping/forcebalance

Folders and files

NameName
Last commit message
Last commit date

Latest commit

12b2662 · Nov 15, 2024
Oct 29, 2024
Jan 11, 2018
Sep 27, 2023
Nov 15, 2024
Sep 27, 2023
Jan 15, 2018
Nov 15, 2024
Feb 4, 2023
Feb 4, 2023
Jan 9, 2019
Jul 14, 2020
Apr 5, 2019
Jan 9, 2019
Jul 25, 2018
Jan 21, 2021
May 15, 2024
Nov 4, 2019
Feb 4, 2023
Nov 4, 2019
Sep 27, 2023
Jan 9, 2019

Repository files navigation

#==================#
#|  ForceBalance  |#
#==================#

If you're reading this, you are probably looking for help. :D

The ForceBalance project website is located at
https://simtk.org/home/forcebalance

There is documentation available online in html at:
http://leeping.github.io/forcebalance/doc/html/index.html

You can also download the documentation in pdf format here:
http://leeping.github.io/forcebalance/doc/ForceBalance-Manual.pdf

#================================#
#|   Conda / pip installation   |#
#================================#

As of version 1.7.4, ForceBalance is available as a package on the conda-forge channel.
To install the package, make sure you are using an Anaconda/Miniconda Python distribution
for Python versions 2.7, 3.5, 3.6, or 3.7, then run:

`conda install --strict-channel-priority -c conda-forge forcebalance`

This will install ForceBalance and all of the required dependencies.  It will not install
optional dependencies such as OpenMM, Gromacs, AMBER, Tinker, CCTools/Work Queue,
or the Open Force Field toolkit.

(Note: If you were installing ForceBalance from the omnia repository previously,
you may need to clear your index cache using `conda clean -i`.)

Similarly, to install from PyPI (Python Package Index), run the command:

`pip install forcebalance`

#=========================================#
#|   Building / installing from source   |#
#=========================================#

To build the package:

python setup.py build

To install the package:

python setup.py install

To install the package locally (i.e. if you don't have root permissions), try the following:

python setup.py install --user
python setup.py install --prefix=$HOME/.local
python setup.py install --prefix=/your/favorite/directory
export PYTHONPATH=/your/favorite/directory

Additionally, the Anaconda/Miniconda distributions are very helpful for setting up a local Python environment.

To turn the package into a distributable .tar.bz2 file:

python setup.py sdist

#========================#
#| Published Parameters |#
#========================#

If you are here to obtain data for a published force field (e.g. AMBER-FB15), you can
find it in the Products folder.  Please email me at leeping (at) ucdavis (dot) edu
if you notice anything that should be added.

#=======================#
#| Citing ForceBalance |#
#=======================#

Published work that utilizes ForceBalance should include the following references:

Wang L-P, Chen J and Van Voorhis T. "Systematic Parametrization of Polarizable Force Fields from Quantum Chemistry Data." 
J. Chem. Theory Comput. 2013, 9, 452-460. DOI: 10.1021/ct300826t

Wang L-P, Martinez TJ and Pande VS. "Building Force Fields: An Automatic, Systematic, and Reproducible Approach." 
J. Phys. Chem. Lett. 2014, 5, 1885-1891. DOI: 10.1021/jz500737m

#===========================#
#| Funding Acknowledgement |#
#===========================#

The development of this code has been supported in part by the following grants and awards:

NIH Grant R01 AI130684-02
ACS-PRF 58158-DNI6
NIH Grant U54 GM072970
Open Force Field Consortium