Skip to content
A template repo for disseminating force fields with foyer
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Getting Started

Installation of Foyer and required tools

conda install -c omnia -c mosdef parmed foyer pytest

Creating a new force field:

  1. Duplicate the force field template. This can be done in various ways:
  1. Create your force field .xml file based on the OpenMM .xml format and add foyer style SMARTS strings to define your atom types. Example force field files:
  1. Optionally, add example molecules with correct atomtypes defined as test cases. Execute the testing script using py.test -v --tb=line
  • Note, even if test molecules are not created, running py.test -v --tb=line is recommended, as this will perform checking of your .xml file for proper syntax and ensure that all atom types references are defined.
  1. Generate your own DOI via Zenodo
  1. Update the link to the Zenodo DOI badge
  • DOI

The text above can be removed upon publishing a forcefield, but please be sure to include the following information in the README:

[Title of your forcefield]

  • Source: [Journal reference(s) if parameters are published (include DOI link)]

  • Forcefield file initially created [DATE] by [Creator(s)]

Source Notes:

< Add specific notes about parameters, e.g., if a set of parameters comes verbatim from prior work, provide details and a DOI >

Additional Notes:

< Add any other relevant information. Also for consistency, please define conversion factors used. Note that we strongly suggest the following unit conversions defined in OpenMM, e.g.: >

  • PI is defined as 3.141592653589 for conversion to radians.
  • kcal/mol to kJ/mol conversion factor is defined as 4.184.

Force field DOI

  • DOI
You can’t perform that action at this time.