OESzmapEngineOptions

class OESzmapEngineOptions

An object used to set one or more options when constructing an OESzmapEngine.

opt.SetProbe(24).SetMaskCutoff(999.99)

When returned by OESzmapEngine.GetOptions, can be used to determine the settings used for a given set of calculations.

opt = sz.GetOptions()
print("norient= %d" % opt.NumOrientations())
print("name   = %s" % opt.GetProbeName())
print("cutoff = %.3f" % opt.GetMaskCutoff())

Constructors

OESzmapEngineOptions() -> OESzmapEngineOptions
OESzmapEngineOptions(rhs: OESzmapEngineOptions) -> OESzmapEngineOptions

Default and copy constructors. The default OESzmapEngineOptions object defines the probe to be a standard SZMAP water with 60 orientations.

opt = oeszmap.OESzmapEngineOptions()

GetMaskCutoff

GetMaskCutoff() -> float

Returns the energy cutoff (in kcal/mol) defining a clash (by default, 0.0; see OEIsClashing and OESzmapEngineOptions.SetMaskCutoff). A clash means every orientation of the probe had a combined OEComponent_Interaction + OEComponent_VDW energy total greater than the cutoff.

GetProbe

GetProbe() -> OEMol

Returns a reference to the current multi-conformer probe molecule (see OESzmapEngineOptions.SetProbe).

p = opt.GetProbe()
print("probe nconf = %d" % p.NumConfs())

GetProbeMol

GetProbeMol(outputMol: Union[OEGraphMol,OEMol,OEQMol],
            orientation: int = 0) -> None

Updates outputMol to contain a specific orientation of the current multi-conformer probe (see OESzmapEngineOptions.SetProbe). By default, the first orientation is returned.

mol = oechem.OEGraphMol()
opt.GetProbeMol(mol)

GetProbeName

GetProbeName() -> str

Returns the standard name of the current probe type (e.g. "water").

NumOrientations

NumOrientations() -> int

Returns the number of orientations for the current probe (see OESzmapEngineOptions.SetProbe).

SetMaskCutoff

SetMaskCutoff(cutoff: float) -> OESzmapEngineOptions

Set the energy cutoff (in kcal/mol) defining a clash (by default, 0.0; see OEIsClashing and OESzmapEngineOptions.GetMaskCutoff). A clash means every orientation of the probe had a combined OEComponent_Interaction + OEComponent_VDW energy total greater than the cutoff.

SetProbe

SetProbe(numOrientations: int) -> OESzmapEngineOptions

Define the current multi-conformation probe molecule to be a standard SZMAP water molecule with the specified number of orientations (see The Szmap TK Standard Water Model for more information on the geometry and charges used).

If numOrientations is set to 24, 60, 216, 360, or 648 then the set of orientations will be symmetric. Otherwise, it will include random orientations and may have lopsided gaps in coverage. For most purposes, 60 is the minimum required for reliable energy calculations and 360 generates higher-precision results, although with a speed penalty due to the additional Zap calculations.

opt.SetProbe(360)

The default OESzmapEngineOptions standard SZMAP water has 60 orientations.