The Open Force Field toolkit
The Open Force Field Toolkit, built by the Open Force Field Initiative, is a Python toolkit for the development and application of modern molecular mechanics force fields based on direct chemical perception and rigorous statistical parameterization methods.
The toolkit currently covers two main areas we have committed to stably maintain throughout their lifetimes:
- Tools for using the SMIRKS Native Open Force Field (SMIRNOFF) specification
- Tools for direct chemical environment perception and manipulation
Note: Prior to version 0.9.0, this toolkit and its associated repository were named
openforcefield and used different import paths. For details on this change and migration instructions, see the release notes of version 0.9.0.
The Open Force Field Toolkit (
openff-toolkit) is a Python toolkit, and supports Python 3.7, 3.8 and 3.9.
Installing via conda
Detailed installation instructions can be found here.
Installing from source
If you need to install via source, see the build and run package requirements listed in the development conda recipe.
Two major force field development efforts have been undertaken by the Initiative, with results hosted in separate repositories.
- The Open Force Fields repository, which features the Parsley force field line. This is the Open Force Field Initiative's first effort toward building a new force field. The initial parameters are taken from smirnoff99Frosst, but software and data produced by the Initiative's efforts are being used to refit parameter values and add new SMIRKS-based parameters.
- The smirnoff99Frosst repository, which is descended from AMBER's parm99 force field as well as Merck-Frosst's parm@frosst. This line of force fields does not aim to alter parameter values, but is instead a test of accurately converting an atom type-based force field to the SMIRNOFF format.
Force fields from both of these packages are available in their respective GitHub repositories and also as conda packages. Tables detailing the individual file names/versions within these force field lines are in the README of each repository. By default, installing the Open Force Field toolkit using
conda or the single-file toolkit installers will also install these conda packages. A plugin architecture is provided for other force field developers to produce python/conda packages that can be imported by the Open Force Field Toolkit as well.
The SMIRKS Native Open Force Field (SMIRNOFF) format
This repository provides tools for using the SMIRKS Native Open Force Field (SMIRNOFF) specification, which currently supports an XML representation for force field definition files.
By convention, files containing XML representations of SMIRNOFF force fields carry
.offxml force field definitions can be found in
openff/toolkit/data/test_forcefields/. These force fields are for testing only, and we neither record versions of these files, nor do we guarantee their correctness or completeness.
Working with SMIRNOFF parameter sets
ForceField class is essentially a drop-in replacement for the OpenMM
# Load a molecule into the OpenFF Molecule object from openff.toolkit.topology import Molecule from openff.toolkit.utils import get_data_file_path sdf_file_path = get_data_file_path('molecules/ethanol.sdf') molecule = Molecule.from_file(sdf_file_path) # Create an OpenFF Topology object from the molecule from openff.toolkit.topology import Topology topology = Topology.from_molecules(molecule) # Load the latest OpenFF force field definition from openff.toolkit.typing.engines.smirnoff import ForceField forcefield = ForceField('openff-1.2.0.offxml') # Create an OpenMM system representing the molecule with SMIRNOFF-applied parameters openmm_system = forcefield.create_openmm_system(topology)
Detailed examples of using SMIRNOFF with the toolkit can be found in the documentation.
Frequently asked questions (FAQ)
FAQ.md for answers to a variety of common problems, such as:
- Why do I need to provide molecules corresponding to the components of my system, or a
Topologywith bond orders?
- Can I use an AMBER, CHARMM, or gromacs topology/coordinate file as a starting point for applying a SMIRNOFF force field?
- What if I am starting from a PDB file?
For a full list of contributors, see the GitHub Contributors page.