.. oe:namespace:: OEChem


.. oe:constnamespace:: OEMCMolType

   The :oe:constns:`OEChem::OEMCMolType` namespace encodes symbolic constants
   representing  specific :ref:`OEMCMolBase <OEChem_OEMCMolBase>` class implementation types.

   .. seealso::

      * :oe:meth:`OEChem::OEMol::Constructors` function
      * :oe:func:`OEChem::OENewMCMolBase` function

   This namespace contains the following constants:

   .. oe:constant:: Cartesian
   
      The same as :oe:const:`OEChem::OEMCMolType::FloatCartesian` and
      :oe:const:`OEChem::OEMCMolType::OEDefault`. The default
      :ref:`OEMol <OEChem_OEMol>` implementation. Conformer coordinates are
      stored in 32-bit ``float`` precision representation.

   .. oe:constant:: DoubleCartesian

      Conformer coordinates will be stored in 64-bit ``double``
      precision. Useful by applications requiring a higher degree of
      precision, like numerical optimization or quantum
      mechanics. Writing out molecules of this type to
      :oe:const:`OEChem::OEFormat::XYZ` or
      :oe:const:`OEChem::OEFormat::OEB` file formats will maintain this
      level of precision. Even rotor-offset-compressed OEB files can
      maintain precision to the 15th decimal place when using a
      ``DoubleCartesian`` :ref:`OEMol <OEChem_OEMol>`.

   .. oe:constant:: FloatCartesian

      The same as :oe:const:`OEChem::OEMCMolType::Cartesian` and
      :oe:const:`OEChem::OEMCMolType::OEDefault`. The default
      :ref:`OEMol <OEChem_OEMol>` implementation. Conformer coordinates are
      stored in 32-bit ``float`` precision representation.

   .. oe:constant:: HalfFloatCartesian

      Conformer coordinates will be stored in 16-bit
      :ref:`OEHalfFloat <OEPlatform_OEHalfFloat>` precision defined by the IEEE
      754-2008 standard. Useful for applications that need to conserve
      memory or file size. Writing out molecules of this type to
      :oe:const:`OEChem::OEFormat::OEB` will only preserve 4 decimal
      places of precision in conformer
      coordinates. Rotor-offset-compressed OEB files will only
      preserve up to the 2nd decimal place for conformer coordinates. 

   .. oe:constant:: LongDoubleCartesian

      Conformer coordinates will be stored in ``long double``
      precision. ``long double`` precision is implementation defined,
      only defined to be greater than or equal to 64-bits. Writing out
      molecules of this type to :oe:const:`OEChem::OEFormat::OEB` first
      convert to ``double`` precision and only 64-bits of precision
      will be preserved.

   .. oe:constant:: OEDBMCMol
   
      An implementation of :ref:`OEMCMolBase <OEChem_OEMCMolBase>` designed to
      have a very small memory footprint when compressed using the
      :oe:meth:`OEChem::OEMolBase::Compress` method. Compressed
      molecules are very fragile, the only operations that are valid
      is destruction, :oe:meth:`OEChem::OEMolBase::Clear`, and
      :oe:meth:`OEChem::OEMolBase::UnCompress`. Using any other method
      is undefined. Users should uncompress the molecule before
      working with it.

   .. oe:constant:: OEDefault

      The same as :oe:const:`OEChem::OEMCMolType::Cartesian` and
      :oe:const:`OEChem::OEMCMolType::FloatCartesian`. The default
      :ref:`OEMol <OEChem_OEMol>` implementation. Conformer coordinates are
      stored in 32-bit ``float`` precision representation.

   .. oe:constant:: Undefined

      Used to signal errors and undefined behavior. 

   .. oe:constant:: MaxType
   
      How many unique numerical constants are in this namespace. 
