ForceField Engine Options¶
Details of the ForceField engine can be set via its input block. Some option are specific to UFF and others to other force fields.
Common options¶
These options apply to any force field.
Type¶
There are a few predefined force field types, that, if used, require no other input.
Type [UFF | Amber95 | GAFF | Tripos5.2 | UserDefined]
Type
Type: Multiple Choice Default value: UFF Options: [UFF, Amber95, GAFF, Tripos5.2, UserDefined] Description: Type of force field to be used
Non bonded screening¶
The long range interaction (dispersion and Coulomb) are the most expensive to evaluate. This gives you the option to screen more aggressively the interaction.
MaxDistanceForNonBonded float
MaxDistanceForNonBonded
Type: Float Default value: 100.0 Unit: Bohr Description: Distance beyond which the non-bonded pair interactions (coulomb and van-der-waals) will be ignored. The interactions are smoothly damped starting from a distance 10% less. Has no effect on the Coulomb term for periodic systems, as Ewald summation is used.
Feedback¶
If you want to know more about the details of the force field you should crank up the verbosity.
Verbosity [Silent | Normal | Verbose | VeryVerbose]
Verbosity
Type: Multiple Choice Default value: Silent Options: [Silent, Normal, Verbose, VeryVerbose] Description: Controls the verbosity of the engine.
Bonds usage¶
Bonds can be specified in the input, still you may not want to use those. Here are some options to control this.
BondsUsage [Input | None | Guess | Auto]
BondsUsage
Type: Multiple Choice Default value: Auto Options: [Input, None, Guess, Auto] Description: Controls what bonds are used by the engine. The choice auto means: guess in case there are no bonds. Guessing only happens at the first MD step, or first geometry optimization step.
Ewald summation¶
For periodic systems the Ewald summation is performed for the Coulomb interaction. It has a couple of options:
EwaldSummation
Alpha float
CellRangeFactor float
Tolerance float
End
EwaldSummation
Type: Block Description: Configures the details of the Ewald summation of the Coulomb interaction. Alpha
Type: Float Default value: -1.0 Description: Negative value means automatic. This parameter does not influence the result, but shifts the workload from real space (smaller alpha) to reciprocal space (larger alpha). CellRangeFactor
Type: Float Default value: 2.0 Description: Smaller values will make the Ewald summation less accurate but faster. Tolerance
Type: Float Default value: 1e-10 Description: Larger values will make the Ewald summation less accurate but faster.
Disabling energy terms¶
By default all force field energy terms are calculated, however, you can disable each one of them individually.
EnergyTerms
Angle Yes/No
Coulomb Yes/No
Dispersion Yes/No
Inversion Yes/No
Stretch Yes/No
Torsion Yes/No
End
EnergyTerms
Type: Block Description: expert key, that allows you to disable specific energy terms. Angle
Type: Bool Default value: Yes Description: Whether to use angle (bend) energy. Coulomb
Type: Bool Default value: Yes Description: Whether to use coulomb energy. Dispersion
Type: Bool Default value: Yes Description: Whether to use dispersion energy. Inversion
Type: Bool Default value: Yes Description: Whether to use inversion energy. Stretch
Type: Bool Default value: Yes Description: Whether to use stretch energy. Torsion
Type: Bool Default value: Yes Description: Whether to use torsion energy.
Guessing or loading partial charges¶
The UFF forcefield has some very rudimentary partial charges guessing, only setting charges for atoms in water molecules. By default the partial charges in a force field calculation are zero. Essentially you will always need to specify atomic charges to make the results more realistic, either via the input or using one or the following options.
See also example LoadCharges, and ChargedMolecules.
GuessCharges¶
The simplest way is the use the GuessCharges key, that uses an engine that can calculate atomic charges. By default DFTB is used. DFTB is of course much more expensive than a forcefield, but if you run a MD calculation you can maybe afford a single DFTB calculation on the system.
GuessCharges Yes/No
GuessCharges
Type: Bool Default value: No Description: Use another engine to calculate/guess the charges to be used by the force field.
If you want to control the engine use the GuessChargesConfig key.
GuessChargesConfig
EngineType string
End
GuessChargesConfig
Type: Block Description: Guess charges to be used by the forcefield EngineType
Type: String Default value: dftb Description: Engine that can calculate or guess charges
LoadCharges¶
You have more control over the charge guessing, by loading the charges of another calculation. This way you can set any engine specific detail, such as the basis set, or functional.
You can load charges form a previous calculation to be used as force field charges.
LoadCharges
File string
Section string
Variable string
End
LoadCharges
Type: Block Description: Load charges from a file to be used as forcefield charges File
Type: String Description: Name of the (kf) file Section
Type: String Default value: AMSResults Description: Section name of the kf file Variable
Type: String Default value: Charges Description: variable name of the kf file
Non UFF options¶
These options are relevant for non-UFF force fields:
AllowMissingParameters Yes/No
AllowMissingParameters
Type: Bool Default value: No Description: When parameters are not found for bonds, angles, dihedrals, or inversions, the first entry in the database will be used.
CheckDuplicateRules Yes/No
CheckDuplicateRules
Type: Bool Default value: Yes Description: The database could contain duplicate entries. For torsions this is a feature, and the potentials will be added. For all other terms this is no allowed, and if detected the program stops. One should fix the database or set the checking to false. As always the last entry will be used.
ForceFieldFile string
ForceFieldFile
Type: String Default value: GUI name: Force field library Description: Path to the force field parameter file
UFF options¶
The following options are only relevant for the UFF force field:
UFF
AtomTypesFile string
Database string
ElementsFile string
Library [UFF | UFF4MOF | UFF4MOF-II]
End
UFF
Type: Block Description: Option for the UFF force filed. AtomTypesFile
Type: String Default value: mmatomtypes_db Description: Expert option: Select the file that defines how UFF determines the atom types Database
Type: String Default value: general_db Description: Expert option: Select the file that defines the UFF parameters per atom type ElementsFile
Type: String Default value: elements_db Description: Expert option: Select the file that defines the elements known to UFF Library
Type: Multiple Choice Default value: UFF Options: [UFF, UFF4MOF, UFF4MOF-II] GUI name: Force field library Description: Selects the used parameter library.