Skip to content

An automated framework for generating optimized partial charges for molecules

License

Notifications You must be signed in to change notification settings

openforcefield/openff-recharge

Repository files navigation

OpenFF Recharge

Test status CI Status pre-commit.ci status
Code quality pre-commit Codecov coverage
Latest release GitHub release (latest by date including pre-releases)
User support Documentation Status Discussions

OpenFF Recharge aims to provide a comprehensive suite of tools for training the partial charges of molecules against quantum chemical electrostatic potential (ESP) and electric field data.

A focus is given to training 'charge-correction models' similar to the popular AM1BCC charge model, but support for other methods such as deriving RESP charges or training virtual sites on top of existing partial charges is also supported.

Warning - although a significant effort has been made to ensure the scientific validity of this framework (especially the hand-converted AM1BCC parameters), it is still under heavy development and much care should be taken when using it in production work.

Getting Started

To start using this framework we recommend looking over the documentation, especially the installation and quick start guides.

How to Cite

Please cite OpenFF Recharge using the Zenodo record of the latest release or the version that was used. The BibTeX reference of the latest release can be found here.

Features

The framework currently supports:

  • Generating QC ESP and electric field data

    • directly by interfacing with the Psi4 quantum chemical code
    • from wavefunctions stored within a QCFractal instance, including the QCArchive
  • Defining new charge models that contain

    • base QC (e.g. AM1 charges) or tabulated library / RESP charges
    • bond-charge corrections
    • virtual sites
  • A SMARTS port of the AM1BCC charge model

  • Generating RESP charges for multi-conformer molecules

  • Training charge(-correction) parameters by

    • the normal linear least squares method (fixed v-site geometries only)
    • gradient descent using pytorch or numpy
    • Bayesian methods using frameworks like pyro

License

The main package is release under the MIT license.

Copyright

Copyright (c) 2020, Open Force Field Consortium

About

An automated framework for generating optimized partial charges for molecules

Resources

License

Stars

Watchers

Forks

Languages