

Omega TK 4.2.1
================================================================================

New features
--------------------------------------------------------------------------------

* The ability to fix a part of a molecule during conformer generation
  based on maximum common substructure (MCS) has been added. The following new methods
  have been added to the :ref:`OEConfFixOptions <OEConfGen_OEConfFixOptions>`
  to enable this functionality:

    * :ref:`SetFixMCS <OEConfGen_OEConfFixOptions_SetFixMCS>`
    * :ref:`GetFixMCS <OEConfGen_OEConfFixOptions_GetFixMCS>`
    * :ref:`SetMCSFunc <OEConfGen_OEConfFixOptions_SetMCSFunc>`
    * :ref:`GetMCSFunc <OEConfGen_OEConfFixOptions_GetMCSFunc>`
    * :ref:`SetMCSType <OEConfGen_OEConfFixOptions_SetMCSType>`
    * :ref:`GetMCSType <OEConfGen_OEConfFixOptions_GetMCSType>`
    * :ref:`SetMCSMinAtoms <OEConfGen_OEConfFixOptions_SetMCSMinAtoms>`
    * :ref:`GetMCSMinAtoms <OEConfGen_OEConfFixOptions_GetMCSMinAtoms>`

* New methods :ref:`SetIgnoreStereo <OEConfGen_OEMolBuilderOptions_SetIgnoreStereo>`
  and :ref:`GetIgnoreStereo <OEConfGen_OEMolBuilderOptions_GetIgnoreStereo>` have been
  added to :ref:`OEMolBuilderOptions <OEConfGen_OEMolBuilderOptions>` to allow
  continuation of conformer generation when specified stereo signatures in a molecule
  could not be honored.

* New methods :ref:`SetMaxEnumConfs <OEConfGen_OEMolBuilderOptions_SetMaxEnumConfs>`
  and :ref:`GetMaxEnumConfs <OEConfGen_OEMolBuilderOptions_GetMaxEnumConfs>` have been
  added to :ref:`OEMolBuilderOptions <OEConfGen_OEMolBuilderOptions>` to allow
  specifying the  maximum number of conformers to be generated from ring enumeration,
  nitrogen enumeration, and/or hydrogen sampling.

* Verbose mode logging now reports torsion angles sampled, along with the rules,
  during torsion driving.


Minor bug fixes
--------------------------------------------------------------------------------

* Conformer generation with :ref:`OEOmega.Build <OEConfGen_OEOmega_Build>`
  or :ref:`OEMolBuilder.Build <OEConfGen_OEMolBuilder_Build>` now fails correctly
  when specified stereo signatures on a molecule cannot be honored. The existing 
  behavior, to carry on even if stereo signatures could not be honored, can be
  obtained by setting :ref:`IgnoreStereo <OEConfGen_OEMolBuilderOptions_SetIgnoreStereo>`
  to ``true``.

* Ring fragment building during :ref:`OEOmega.Build <OEConfGen_OEOmega_Build>`,
  :ref:`OEFragBuilder.Build <OEConfGen_OEFragBuilder_Build>`,
  :ref:`OEMolBuilder.Build <OEConfGen_OEMolBuilder_Build>`, or
  :ref:`GenerateMissingFrags <OEConfGen_OEMakeFragLib_GenerateMissingFrags>`
  now properly honors the :ref:`SetFragKeep <OEConfGen_OEFragOptions_SetFragKeep>`
  parameter regarding the maximum number of generated fragment conformers to be kept.

