Chemical Data Processing Library Python API - Version 1.4.0
Public Member Functions | Properties | List of all members
CDPL.ForceField.MMFF94EnergyCalculator Class Reference

Calculates the total MMFF94 force field energy for a set of atom 3D coordinates. More...

+ Inheritance diagram for CDPL.ForceField.MMFF94EnergyCalculator:

Public Member Functions

None __init__ ()
 Constructs the calculator without an associated ForceField.MMFF94InteractionData instance. More...
 
None __init__ (MMFF94EnergyCalculator calc)
 Initializes a copy of the MMFF94EnergyCalculator instance calc. More...
 
None __init__ (MMFF94InteractionData ia_data)
 Constructs the calculator and associates it with the supplied ForceField.MMFF94InteractionData instance. More...
 
int getObjectID ()
 Returns the numeric identifier (ID) of the wrapped C++ class instance. More...
 
MMFF94EnergyCalculator assign (MMFF94EnergyCalculator calc)
 Replaces the current state of self with a copy of the state of the MMFF94EnergyCalculator instance calc. More...
 
None setEnabledInteractionTypes (int types)
 Enables/disables specific MMFF94 interaction-type contributions. More...
 
int getEnabledInteractionTypes ()
 Returns the currently enabled interaction-type contributions. More...
 
None setup (MMFF94InteractionData ia_data)
 Associates the calculator with the supplied ForceField.MMFF94InteractionData instance. More...
 
float getTotalEnergy ()
 Returns the total MMFF94 energy computed by the most recent call() call. More...
 
float getBondStretchingEnergy ()
 Returns the bond-stretching energy contribution computed by the most recent call() call. More...
 
float getAngleBendingEnergy ()
 Returns the angle-bending energy contribution computed by the most recent call() call. More...
 
float getStretchBendEnergy ()
 Returns the stretch-bend coupling energy contribution computed by the most recent call() call. More...
 
float getOutOfPlaneBendingEnergy ()
 Returns the out-of-plane bending energy contribution computed by the most recent call() call. More...
 
float getTorsionEnergy ()
 Returns the torsion energy contribution computed by the most recent call() call. More...
 
float getElectrostaticEnergy ()
 Returns the electrostatic energy contribution computed by the most recent call() call. More...
 
float getVanDerWaalsEnergy ()
 Returns the Van der Waals energy contribution computed by the most recent call() call. More...
 
float __call__ (Math.Vector3DArray coords)
 Computes the total MMFF94 energy of the conformation specified by coords. More...
 

Properties

 objectID = property(getObjectID)
 
 enabledInteractionTypes = property(getEnabledInteractionTypes, setEnabledInteractionTypes)
 
 totalEnergy = property(getTotalEnergy)
 
 bondStretchingEnergy = property(getBondStretchingEnergy)
 
 angleBendingEnergy = property(getAngleBendingEnergy)
 
 stretchBendEnergy = property(getStretchBendEnergy)
 
 outOfPlaneBendingEnergy = property(getOutOfPlaneBendingEnergy)
 
 torsionEnergy = property(getTorsionEnergy)
 
 electrostaticEnergy = property(getElectrostaticEnergy)
 
 vanDerWaalsEnergy = property(getVanDerWaalsEnergy)
 

Detailed Description

Calculates the total MMFF94 force field energy for a set of atom 3D coordinates.

The calculator takes a ForceField.MMFF94InteractionData instance (typically produced by ForceField.MMFF94InteractionParameterizer) and computes the bond-stretching, angle-bending, stretch-bend, out-of-plane bending, torsion, electrostatic and Van der Waals energy contributions for a supplied set of atom 3D coordinates. The per-component energies are retained and made available via the dedicated accessors, the calculated sum is returned by call() and getTotalEnergy().

Constructor & Destructor Documentation

◆ __init__() [1/3]

None CDPL.ForceField.MMFF94EnergyCalculator.__init__ ( )

Constructs the calculator without an associated ForceField.MMFF94InteractionData instance.

call() will return zero until setup() has been called.

◆ __init__() [2/3]

None CDPL.ForceField.MMFF94EnergyCalculator.__init__ ( MMFF94EnergyCalculator  calc)

Initializes a copy of the MMFF94EnergyCalculator instance calc.

Parameters
calcThe MMFF94EnergyCalculator instance to copy.

◆ __init__() [3/3]

None CDPL.ForceField.MMFF94EnergyCalculator.__init__ ( MMFF94InteractionData  ia_data)

Constructs the calculator and associates it with the supplied ForceField.MMFF94InteractionData instance.

Parameters
ia_dataThe MMFF94 interaction data to use for energy calculation.

Member Function Documentation

◆ getObjectID()

int CDPL.ForceField.MMFF94EnergyCalculator.getObjectID ( )

Returns the numeric identifier (ID) of the wrapped C++ class instance.

Different Python MMFF94EnergyCalculator instances may reference the same underlying C++ class instance. The commonly used Python expression a is not b thus cannot tell reliably whether the two MMFF94EnergyCalculator instances a and b reference different C++ objects. The numeric identifier returned by this method allows to correctly implement such an identity test via the simple expression a.getObjectID() != b.getObjectID().

Returns
The numeric ID of the internally referenced C++ class instance.

◆ assign()

MMFF94EnergyCalculator CDPL.ForceField.MMFF94EnergyCalculator.assign ( MMFF94EnergyCalculator  calc)

Replaces the current state of self with a copy of the state of the MMFF94EnergyCalculator instance calc.

Parameters
calcThe MMFF94EnergyCalculator instance to copy.
Returns
self

◆ setEnabledInteractionTypes()

None CDPL.ForceField.MMFF94EnergyCalculator.setEnabledInteractionTypes ( int  types)

Enables/disables specific MMFF94 interaction-type contributions.

Parameters
typesBitwise-OR combination of ForceField.InteractionType flags.
Note
Only enabled contributions are evaluated.

◆ getEnabledInteractionTypes()

int CDPL.ForceField.MMFF94EnergyCalculator.getEnabledInteractionTypes ( )

Returns the currently enabled interaction-type contributions.

Returns
The bitwise-OR combination of ForceField.InteractionType flags.

◆ setup()

None CDPL.ForceField.MMFF94EnergyCalculator.setup ( MMFF94InteractionData  ia_data)

Associates the calculator with the supplied ForceField.MMFF94InteractionData instance.

Parameters
ia_dataThe new MMFF94 interaction data to use for energy calculation.

◆ getTotalEnergy()

float CDPL.ForceField.MMFF94EnergyCalculator.getTotalEnergy ( )

Returns the total MMFF94 energy computed by the most recent call() call.

Returns
A reference to the total energy.

◆ getBondStretchingEnergy()

float CDPL.ForceField.MMFF94EnergyCalculator.getBondStretchingEnergy ( )

Returns the bond-stretching energy contribution computed by the most recent call() call.

Returns
A reference to the bond-stretching energy.

◆ getAngleBendingEnergy()

float CDPL.ForceField.MMFF94EnergyCalculator.getAngleBendingEnergy ( )

Returns the angle-bending energy contribution computed by the most recent call() call.

Returns
A reference to the angle-bending energy.

◆ getStretchBendEnergy()

float CDPL.ForceField.MMFF94EnergyCalculator.getStretchBendEnergy ( )

Returns the stretch-bend coupling energy contribution computed by the most recent call() call.

Returns
A reference to the stretch-bend energy.

◆ getOutOfPlaneBendingEnergy()

float CDPL.ForceField.MMFF94EnergyCalculator.getOutOfPlaneBendingEnergy ( )

Returns the out-of-plane bending energy contribution computed by the most recent call() call.

Returns
A reference to the out-of-plane bending energy.

◆ getTorsionEnergy()

float CDPL.ForceField.MMFF94EnergyCalculator.getTorsionEnergy ( )

Returns the torsion energy contribution computed by the most recent call() call.

Returns
A reference to the torsion energy.

◆ getElectrostaticEnergy()

float CDPL.ForceField.MMFF94EnergyCalculator.getElectrostaticEnergy ( )

Returns the electrostatic energy contribution computed by the most recent call() call.

Returns
A reference to the electrostatic energy.

◆ getVanDerWaalsEnergy()

float CDPL.ForceField.MMFF94EnergyCalculator.getVanDerWaalsEnergy ( )

Returns the Van der Waals energy contribution computed by the most recent call() call.

Returns
A reference to the Van der Waals energy.

◆ __call__()

float CDPL.ForceField.MMFF94EnergyCalculator.__call__ ( Math.Vector3DArray  coords)

Computes the total MMFF94 energy of the conformation specified by coords.

The per-component energies are stored internally and can be retrieved via the dedicated accessors.

Parameters
coordsThe atom 3D coordinates.
Returns
A reference to the computed total energy.