![]() |
Chemical Data Processing Library Python API - Version 1.4.0
|
Bundle of configuration parameters for conformer ensemble generation via class ConfGen.ConformerGenerator. More...
Inheritance diagram for CDPL.ConfGen.ConformerGeneratorSettings:Public Member Functions | |
| None | __init__ () |
Constructs the ConformerGeneratorSettings instance with default configuration parameter values. | |
| None | __init__ (ConformerGeneratorSettings settings) |
Initializes a copy of the ConformerGeneratorSettings instance settings. More... | |
| int | getObjectID () |
| Returns the numeric identifier (ID) of the wrapped C++ class instance. More... | |
| ConformerGeneratorSettings | assign (ConformerGeneratorSettings settings) |
Replaces the current state of self with a copy of the state of the ConformerGeneratorSettings instance settings. More... | |
| None | setSamplingMode (int mode) |
| Specifies the conformer-sampling strategy to use. More... | |
| int | getSamplingMode () |
| Returns the currently configured conformer-sampling strategy. More... | |
| None | sampleHeteroAtomHydrogens (bool sample) |
| Specifies whether torsions of heteroatom hydrogen rotors shall be sampled. More... | |
| bool | sampleHeteroAtomHydrogens () |
| Tells whether torsions of heteroatom hydrogen rotors are sampled. More... | |
| None | sampleAngleToleranceRanges (bool sample) |
| Specifies whether additional torsion samples within the tolerance ranges defined by the torsion library entries shall be generated. More... | |
| bool | sampleAngleToleranceRanges () |
| Tells whether tolerance-range sampling is enabled. More... | |
| None | enumerateRings (bool enumerate) |
| Specifies whether ring conformations shall be enumerated. More... | |
| bool | enumerateRings () |
| Tells whether ring conformations are enumerated. More... | |
| None | setNitrogenEnumerationMode (int mode) |
| Sets the enumeration mode for stereogenic nitrogen centers. More... | |
| int | getNitrogenEnumerationMode () |
| Returns the currently configured nitrogen enumeration mode. More... | |
| None | generateCoordinatesFromScratch (bool generate) |
| Specifies whether 3D coordinates shall be generated from scratch (ignoring any 3D input). More... | |
| bool | generateCoordinatesFromScratch () |
| Tells whether 3D coordinates are generated from scratch. More... | |
| None | includeInputCoordinates (bool include) |
| Specifies whether the input conformation shall be included in the output conformer ensemble. More... | |
| bool | includeInputCoordinates () |
| Tells whether the input coordinates are included in the output conformer ensemble. More... | |
| None | setEnergyWindow (float win_size) |
| Sets the energy window size (in kcal/mol) above the found global minimum within which conformers are kept. More... | |
| float | getEnergyWindow () |
| Returns the configured energy window size. More... | |
| float | getEnergyWindow (int num_rot_bonds) |
| Returns the energy window size that applies for molecules with num_rot_bonds rotatable bonds. More... | |
| None | clearEnergyWindowRanges () |
| Removes all registered rotatable bond count-dependent energy window overrides. More... | |
| None | addEnergyWindowRange (int num_rot_bonds, float win_size) |
| Registers an energy window override that applies up to and including num_rot_bonds rotatable bonds. More... | |
| None | setMaxPoolSize (int max_size) |
| Sets the maximum number of conformers to keep in the internal candidate pool. More... | |
| int | getMaxPoolSize () |
| Returns the maximum number of conformers kept in the internal candidate pool. More... | |
| None | setMaxRotatableBondCount (int max_count) |
| Sets the upper limit on the number of rotatable bonds an input molecule may have to be processed. More... | |
| int | getMaxRotatableBondCount () |
| Returns the rotatable bond count limit above which input molecules are rejected. More... | |
| None | setTimeout (int mil_secs) |
| Sets the maximum allowed wall clock processing time per molecule. More... | |
| int | getTimeout () |
| Returns the configured per-molecule wall clock time limit. More... | |
| None | setForceFieldTypeSystematic (int type) |
| Sets the force field type used by the systematic sampling pipeline. More... | |
| int | getForceFieldTypeSystematic () |
| Returns the force field type used by the systematic sampling pipeline. More... | |
| None | setForceFieldTypeStochastic (int type) |
| Sets the force field type used by the stochastic sampling pipeline. More... | |
| int | getForceFieldTypeStochastic () |
| Returns the force field type used by the stochastic sampling pipeline. More... | |
| None | strictForceFieldParameterization (bool strict) |
| Specifies whether strict MMFF94 parameterization is required. More... | |
| bool | strictForceFieldParameterization () |
| Tells whether strict MMFF94 parameterization is required. More... | |
| None | setDielectricConstant (float de_const) |
| Sets the dielectric constant used by the MMFF94 electrostatic interactions. More... | |
| float | getDielectricConstant () |
| Returns the dielectric constant used by the MMFF94 electrostatic interactions. More... | |
| None | setDistanceExponent (float dist_expo) |
| float | getDistanceExponent () |
| Returns the exponent of the MMFF94 distance-dependent electrostatic term. More... | |
| None | setMaxNumOutputConformers (int max_num) |
| Sets the maximum number of output conformers per molecule. More... | |
| int | getMaxNumOutputConformers () |
| Returns the configured maximum number of output conformers. More... | |
| int | getMaxNumOutputConformers (int num_rot_bonds) |
| Returns the maximum number of output conformers that applies for molecules with num_rot_bonds rotatable bonds. More... | |
| None | clearMaxNumOutputConformersRanges () |
| Removes all registered rotatable bond count-dependent output conformer overrides. More... | |
| None | addMaxNumOutputConformersRange (int num_rot_bonds, int max_num) |
| Registers an output conformer limit override that applies up to and including num_rot_bonds rotatable bonds. More... | |
| None | setMinRMSD (float min_rmsd) |
| Sets the minimum pairwise heavy atom RMSD that conformers in the output ensemble must keep. More... | |
| float | getMinRMSD () |
| Returns the globally configured minimum RMSD threshold. More... | |
| float | getMinRMSD (int num_rot_bonds) |
| Returns the minimum RMSD threshold that applies for molecules with num_rot_bonds rotatable bonds. More... | |
| None | clearMinRMSDRanges () |
| Removes all registered rotatable bond count-dependent minimum RMSD overrides. More... | |
| None | addMinRMSDRange (int num_rot_bonds, float min_rmsd) |
| Registers a minimum RMSD override that applies up to and including num_rot_bonds rotatable bonds. More... | |
| None | setMaxNumRefinementIterations (int max_num) |
| int | getMaxNumRefinementIterations () |
| Returns the maximum number of MMFF94 energy minimization iterations per conformer. More... | |
| None | setRefinementStopGradient (float tol) |
| float | getRefinementTolerance () |
| Returns the convergence tolerance of the MMFF94 energy minimization step. More... | |
| None | setMaxNumSampledConformers (int max_num) |
| Sets the upper bound on the number of trial conformations produced by the stochastic sampler. More... | |
| int | getMaxNumSampledConformers () |
| Returns the upper bound on the number of trial conformations produced by the stochastic sampler. More... | |
| None | setConvergenceCheckCycleSize (int size) |
| Sets the cycle size (in trial conformations) at which the stochastic sampler tests for convergence. More... | |
| int | getConvergenceCheckCycleSize () |
| Returns the cycle size at which the stochastic sampler tests for convergence. More... | |
| None | setMacrocycleRotorBondCountThreshold (int max_size) |
| int | getMacrocycleRotorBondCountThreshold () |
| Returns the flexible macrocycle rotatable bond count threshold. More... | |
| FragmentConformerGeneratorSettings | getFragmentBuildSettings () |
| Returns a reference to the nested fragment conformer build settings. More... | |
Static Public Attributes | |
| DEFAULT = _HIDDEN_VALUE_ | |
| Instance providing configuration parameter default values. | |
| SMALL_SET_DIVERSE = _HIDDEN_VALUE_ | |
| Preset producing a small, diversity-optimized conformer ensemble. | |
| MEDIUM_SET_DIVERSE = _HIDDEN_VALUE_ | |
| Preset producing a medium-sized, diversity-optimized conformer ensemble. | |
| LARGE_SET_DIVERSE = _HIDDEN_VALUE_ | |
| Preset producing a large, diversity-optimized conformer ensemble. | |
| SMALL_SET_DENSE = _HIDDEN_VALUE_ | |
| Preset producing a small, dense conformer ensemble (tight RMSD threshold). | |
| MEDIUM_SET_DENSE = _HIDDEN_VALUE_ | |
| Preset producing a medium-sized, dense conformer ensemble (tight RMSD threshold). | |
| LARGE_SET_DENSE = _HIDDEN_VALUE_ | |
| Preset producing a large, dense conformer ensemble (tight RMSD threshold). | |
Bundle of configuration parameters for conformer ensemble generation via class ConfGen.ConformerGenerator.
| None CDPL.ConfGen.ConformerGeneratorSettings.__init__ | ( | ConformerGeneratorSettings | settings | ) |
Initializes a copy of the ConformerGeneratorSettings instance settings.
| settings | The ConformerGeneratorSettings instance to copy. |
| int CDPL.ConfGen.ConformerGeneratorSettings.getObjectID | ( | ) |
Returns the numeric identifier (ID) of the wrapped C++ class instance.
Different Python ConformerGeneratorSettings 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 ConformerGeneratorSettings 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().
| ConformerGeneratorSettings CDPL.ConfGen.ConformerGeneratorSettings.assign | ( | ConformerGeneratorSettings | settings | ) |
Replaces the current state of self with a copy of the state of the ConformerGeneratorSettings instance settings.
| settings | The ConformerGeneratorSettings instance to copy. |
| None CDPL.ConfGen.ConformerGeneratorSettings.setSamplingMode | ( | int | mode | ) |
Specifies the conformer-sampling strategy to use.
| mode | One of the ConfGen.ConformerSamplingMode values. |
| int CDPL.ConfGen.ConformerGeneratorSettings.getSamplingMode | ( | ) |
Returns the currently configured conformer-sampling strategy.
| None CDPL.ConfGen.ConformerGeneratorSettings.sampleHeteroAtomHydrogens | ( | bool | sample | ) |
Specifies whether torsions of heteroatom hydrogen rotors shall be sampled.
| sample | If True, such torsions are sampled. |
| bool CDPL.ConfGen.ConformerGeneratorSettings.sampleHeteroAtomHydrogens | ( | ) |
Tells whether torsions of heteroatom hydrogen rotors are sampled.
True if sampling is enabled, and False otherwise. | None CDPL.ConfGen.ConformerGeneratorSettings.sampleAngleToleranceRanges | ( | bool | sample | ) |
Specifies whether additional torsion samples within the tolerance ranges defined by the torsion library entries shall be generated.
| sample | If True, tolerance-range sampling is enabled. |
| bool CDPL.ConfGen.ConformerGeneratorSettings.sampleAngleToleranceRanges | ( | ) |
Tells whether tolerance-range sampling is enabled.
True if tolerance-range sampling is enabled, and False otherwise. | None CDPL.ConfGen.ConformerGeneratorSettings.enumerateRings | ( | bool | enumerate | ) |
Specifies whether ring conformations shall be enumerated.
| enumerate | If True, ring conformations are enumerated. |
| bool CDPL.ConfGen.ConformerGeneratorSettings.enumerateRings | ( | ) |
Tells whether ring conformations are enumerated.
True if ring conformations are enumerated, and False otherwise. | None CDPL.ConfGen.ConformerGeneratorSettings.setNitrogenEnumerationMode | ( | int | mode | ) |
Sets the enumeration mode for stereogenic nitrogen centers.
| mode | One of the ConfGen.NitrogenEnumerationMode values. |
| int CDPL.ConfGen.ConformerGeneratorSettings.getNitrogenEnumerationMode | ( | ) |
Returns the currently configured nitrogen enumeration mode.
| None CDPL.ConfGen.ConformerGeneratorSettings.generateCoordinatesFromScratch | ( | bool | generate | ) |
Specifies whether 3D coordinates shall be generated from scratch (ignoring any 3D input).
| generate | If True, 3D coordinates are always generated from scratch. |
| bool CDPL.ConfGen.ConformerGeneratorSettings.generateCoordinatesFromScratch | ( | ) |
Tells whether 3D coordinates are generated from scratch.
True if 3D coordinates are always regenerated, and False otherwise. | None CDPL.ConfGen.ConformerGeneratorSettings.includeInputCoordinates | ( | bool | include | ) |
Specifies whether the input conformation shall be included in the output conformer ensemble.
| include | If True, the input coordinates become part of the output ensemble. |
| bool CDPL.ConfGen.ConformerGeneratorSettings.includeInputCoordinates | ( | ) |
Tells whether the input coordinates are included in the output conformer ensemble.
True if the input coordinates are included, and False otherwise. | None CDPL.ConfGen.ConformerGeneratorSettings.setEnergyWindow | ( | float | win_size | ) |
Sets the energy window size (in kcal/mol) above the found global minimum within which conformers are kept.
| win_size | The new energy window size in kcal/mol. |
| float CDPL.ConfGen.ConformerGeneratorSettings.getEnergyWindow | ( | ) |
Returns the configured energy window size.
| float CDPL.ConfGen.ConformerGeneratorSettings.getEnergyWindow | ( | int | num_rot_bonds | ) |
Returns the energy window size that applies for molecules with num_rot_bonds rotatable bonds.
If a rotatable bond-specific range was registered via addEnergyWindowRange(), the matching value is returned. Otherwise, the global window from getEnergyWindow() is used.
| num_rot_bonds | The rotatable bond count. |
| None CDPL.ConfGen.ConformerGeneratorSettings.clearEnergyWindowRanges | ( | ) |
Removes all registered rotatable bond count-dependent energy window overrides.
| None CDPL.ConfGen.ConformerGeneratorSettings.addEnergyWindowRange | ( | int | num_rot_bonds, |
| float | win_size | ||
| ) |
Registers an energy window override that applies up to and including num_rot_bonds rotatable bonds.
| num_rot_bonds | The upper-bound rotatable bond count to which win_size applies. |
| win_size | The energy window size (in kcal/mol). |
| None CDPL.ConfGen.ConformerGeneratorSettings.setMaxPoolSize | ( | int | max_size | ) |
Sets the maximum number of conformers to keep in the internal candidate pool.
| max_size | The new maximum pool size. |
| int CDPL.ConfGen.ConformerGeneratorSettings.getMaxPoolSize | ( | ) |
Returns the maximum number of conformers kept in the internal candidate pool.
| None CDPL.ConfGen.ConformerGeneratorSettings.setMaxRotatableBondCount | ( | int | max_count | ) |
Sets the upper limit on the number of rotatable bonds an input molecule may have to be processed.
| max_count | The new rotatable bond count limit (-1 disables the limit). |
| int CDPL.ConfGen.ConformerGeneratorSettings.getMaxRotatableBondCount | ( | ) |
Returns the rotatable bond count limit above which input molecules are rejected.
| None CDPL.ConfGen.ConformerGeneratorSettings.setTimeout | ( | int | mil_secs | ) |
Sets the maximum allowed wall clock processing time per molecule.
| mil_secs | The new time limit in milliseconds (zero disables the limit). |
| int CDPL.ConfGen.ConformerGeneratorSettings.getTimeout | ( | ) |
Returns the configured per-molecule wall clock time limit.
| None CDPL.ConfGen.ConformerGeneratorSettings.setForceFieldTypeSystematic | ( | int | type | ) |
Sets the force field type used by the systematic sampling pipeline.
| type | One of the ConfGen.ForceFieldType values. |
| int CDPL.ConfGen.ConformerGeneratorSettings.getForceFieldTypeSystematic | ( | ) |
Returns the force field type used by the systematic sampling pipeline.
| None CDPL.ConfGen.ConformerGeneratorSettings.setForceFieldTypeStochastic | ( | int | type | ) |
Sets the force field type used by the stochastic sampling pipeline.
| type | One of the ConfGen.ForceFieldType values. |
| int CDPL.ConfGen.ConformerGeneratorSettings.getForceFieldTypeStochastic | ( | ) |
Returns the force field type used by the stochastic sampling pipeline.
| None CDPL.ConfGen.ConformerGeneratorSettings.strictForceFieldParameterization | ( | bool | strict | ) |
Specifies whether strict MMFF94 parameterization is required.
| strict | If True, missing/ambiguous parameters cause a generation failure. Otherwise, in case of parameterization problems, suitable fallback parameters will be used. |
| bool CDPL.ConfGen.ConformerGeneratorSettings.strictForceFieldParameterization | ( | ) |
Tells whether strict MMFF94 parameterization is required.
True if strict parameterization is required, and False otherwise. | None CDPL.ConfGen.ConformerGeneratorSettings.setDielectricConstant | ( | float | de_const | ) |
Sets the dielectric constant used by the MMFF94 electrostatic interactions.
| de_const | The new dielectric constant. |
| float CDPL.ConfGen.ConformerGeneratorSettings.getDielectricConstant | ( | ) |
Returns the dielectric constant used by the MMFF94 electrostatic interactions.
| None CDPL.ConfGen.ConformerGeneratorSettings.setDistanceExponent | ( | float | dist_expo | ) |
| dist_expo |
| float CDPL.ConfGen.ConformerGeneratorSettings.getDistanceExponent | ( | ) |
Returns the exponent of the MMFF94 distance-dependent electrostatic term.
| None CDPL.ConfGen.ConformerGeneratorSettings.setMaxNumOutputConformers | ( | int | max_num | ) |
Sets the maximum number of output conformers per molecule.
| max_num | The new output conformer count limit. |
| int CDPL.ConfGen.ConformerGeneratorSettings.getMaxNumOutputConformers | ( | ) |
Returns the configured maximum number of output conformers.
| int CDPL.ConfGen.ConformerGeneratorSettings.getMaxNumOutputConformers | ( | int | num_rot_bonds | ) |
Returns the maximum number of output conformers that applies for molecules with num_rot_bonds rotatable bonds.
If a rotatable bond-specific range was registered via addMaxNumOutputConformersRange(), the matching value is returned. Otherwise, the global limit from getMaxNumOutputConformers() is used.
| num_rot_bonds | The rotatable bond count. |
| None CDPL.ConfGen.ConformerGeneratorSettings.clearMaxNumOutputConformersRanges | ( | ) |
Removes all registered rotatable bond count-dependent output conformer overrides.
| None CDPL.ConfGen.ConformerGeneratorSettings.addMaxNumOutputConformersRange | ( | int | num_rot_bonds, |
| int | max_num | ||
| ) |
Registers an output conformer limit override that applies up to and including num_rot_bonds rotatable bonds.
| num_rot_bonds | The upper-bound rotatable bond count to which max_num applies. |
| max_num | The output conformer limit used for matching molecules. |
| None CDPL.ConfGen.ConformerGeneratorSettings.setMinRMSD | ( | float | min_rmsd | ) |
Sets the minimum pairwise heavy atom RMSD that conformers in the output ensemble must keep.
| min_rmsd | The new minimum RMSD threshold (in Å). |
| float CDPL.ConfGen.ConformerGeneratorSettings.getMinRMSD | ( | ) |
Returns the globally configured minimum RMSD threshold.
| float CDPL.ConfGen.ConformerGeneratorSettings.getMinRMSD | ( | int | num_rot_bonds | ) |
Returns the minimum RMSD threshold that applies for molecules with num_rot_bonds rotatable bonds.
If a rotatable bond-specific range was registered via addMinRMSDRange(), the matching value is returned. Otherwise, the global threshold from getMinRMSD() is used.
| num_rot_bonds | The rotatable bond count. |
| None CDPL.ConfGen.ConformerGeneratorSettings.clearMinRMSDRanges | ( | ) |
Removes all registered rotatable bond count-dependent minimum RMSD overrides.
| None CDPL.ConfGen.ConformerGeneratorSettings.addMinRMSDRange | ( | int | num_rot_bonds, |
| float | min_rmsd | ||
| ) |
Registers a minimum RMSD override that applies up to and including num_rot_bonds rotatable bonds.
| num_rot_bonds | The upper-bound rotatable bond count to which min_rmsd applies. |
| min_rmsd | The minimum RMSD threshold used for matching molecules. |
| None CDPL.ConfGen.ConformerGeneratorSettings.setMaxNumRefinementIterations | ( | int | max_num | ) |
| max_num |
| int CDPL.ConfGen.ConformerGeneratorSettings.getMaxNumRefinementIterations | ( | ) |
Returns the maximum number of MMFF94 energy minimization iterations per conformer.
| None CDPL.ConfGen.ConformerGeneratorSettings.setRefinementStopGradient | ( | float | tol | ) |
| tol |
| float CDPL.ConfGen.ConformerGeneratorSettings.getRefinementTolerance | ( | ) |
Returns the convergence tolerance of the MMFF94 energy minimization step.
| None CDPL.ConfGen.ConformerGeneratorSettings.setMaxNumSampledConformers | ( | int | max_num | ) |
Sets the upper bound on the number of trial conformations produced by the stochastic sampler.
| max_num | The new sampled conformer limit. |
| int CDPL.ConfGen.ConformerGeneratorSettings.getMaxNumSampledConformers | ( | ) |
Returns the upper bound on the number of trial conformations produced by the stochastic sampler.
| None CDPL.ConfGen.ConformerGeneratorSettings.setConvergenceCheckCycleSize | ( | int | size | ) |
Sets the cycle size (in trial conformations) at which the stochastic sampler tests for convergence.
| size | The new convergence check cycle size. |
| int CDPL.ConfGen.ConformerGeneratorSettings.getConvergenceCheckCycleSize | ( | ) |
Returns the cycle size at which the stochastic sampler tests for convergence.
| None CDPL.ConfGen.ConformerGeneratorSettings.setMacrocycleRotorBondCountThreshold | ( | int | max_size | ) |
| max_size |
| int CDPL.ConfGen.ConformerGeneratorSettings.getMacrocycleRotorBondCountThreshold | ( | ) |
Returns the flexible macrocycle rotatable bond count threshold.
| FragmentConformerGeneratorSettings CDPL.ConfGen.ConformerGeneratorSettings.getFragmentBuildSettings | ( | ) |
Returns a reference to the nested fragment conformer build settings.