.. oe:namespace:: OEChem

.. include:: ../substitutions

..  _OEChem_OEOFlavor:

.. oe:constnamespace:: OEOFlavor

   The :oe:constns:`OEChem::OEOFlavor` namespace encodes symbolic
   constants used as bit-masks to indicate how to read various
   file formats by **OEChem TK**.

   The :oe:constns:`OEChem::OEOFlavor::Generic` namespace within
   :oe:constns:`OEChem::OEOFlavor` defines control bit-masks that are
   common to all of the output formats.
   Although these generic bits are common to all file formats, they
   may be specified independently for each file format.

   .. seealso::

      * :oe:meth:`OEChem::oemolostream::SetFormat` method to set the flavor of an output molecule stream
      * :oe:meth:`OEChem::oemolstreambase::GetFormat` method to retrieve the flavor of a molecule stream

   The interpretation of many of these flavor values, is identical to
   those passed to the corresponding **OEChem TK** low-level file format
   writers.

   This namespace contains the following namespaces:

   .. ################################################################
      #
      ################################################################

..  _OEChem_OEOFlavor_CAN:

   .. oe:constnamespace:: OEOFlavor::CAN

      The :oe:constns:`OEChem::OEOFlavor::CAN` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OECreateSmiString` function
      when writing a molecule into a :oe:const:`OEChem::OEFormat::CAN`
      format file.

      .. note::

         If no aromaticity model is specified for the
         :oe:constns:`OEChem::OEOFlavor::Generic` namespace for this file format,
         then the OpenEye  model is used by default to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      This namespace contains the following constants:

      .. oe:constant:: AllBonds

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AllBonds` constant.

      .. oe:constant:: AtomMaps

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AtomMaps` constant.

      .. oe:constant:: AtomStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AtomStereo` constant.

      .. oe:constant:: BondStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::BondStereo` constant.

      .. oe:constant:: Canonical

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Canonical` constant.

      .. oe:constant:: DEFAULT

         Same as the :oe:const:`OEChem::OEOFlavor::CAN::Default` constant.

      .. oe:constant:: Default

         Combination of
         :oe:const:`OEChem::OEOFlavor::CAN::AtomMaps`,
         :oe:const:`OEChem::OEOFlavor::CAN::Canonical` and
         :oe:const:`OEChem::OEOFlavor::CAN::RGroups` flags.

      .. oe:constant:: EnhStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::EnhStereo` constant.

      .. oe:constant:: ExtBonds

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::ExtBonds` constant.

      .. oe:constant:: Hydrogens

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Hydrogens` constant.

      .. oe:constant:: ImpHCount

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::ImpHCount` constant.

      .. oe:constant:: Isotopes

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Isotopes` constant.

      .. oe:constant:: Kekule

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Kekule` constant.

      .. oe:constant:: RGroups

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::RGroups` constant.

      .. oe:constant:: SmiMask

      .. oe:constant:: SuperAtoms

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::SuperAtoms` constant.


   .. ################################################################
      #
      ################################################################

..  _OEChem_OEOFlavor_CDX:

   .. oe:constnamespace:: OEOFlavor::CDX

      .. note::

         If no aromaticity model is specified for the
         :oe:constns:`OEChem::OEOFlavor::Generic` namespace for this file format,
         then the OpenEye model is used by default to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      This namespace contains the following constants:

      .. oe:constant:: Add2D

         This flag indicates that 2D coordinates are generated prior to
         writing a molecule by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.
         If the molecule already has 2D coordinates then
         these coordinates are left intact.
         In certain cases the 2D layout may result in incorrect stereochemistry
         in the resulting connection table.  In these cases no coordinates
         are generated.

      .. oe:constant:: UnsetBad2DStereo

         This flag is used with the Add2D constant.  In certain cases
         the 2D layout may result in incorrect stereochemistry in the output
         connection table format.  When this flag is set the writer will
         output the generated coordinates and set the stereochemistry of the
         offending stereocenters to 'Undefined'.

      .. oe:constant:: Default

         Same as the :oe:const:`OEChem::OEOFlavor::CDX::Add2D` constant.


   .. ################################################################
      #
      ################################################################

..  _OEChem_OEOFlavor_CIF:

   .. oe:constnamespace:: OEOFlavor::CIF

      .. note::

         If no aromaticity model is specified for the
         :oe:constns:`OEChem::OEOFlavor::Generic` namespace for this file format,
         then the OpenEye model is used by default to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      This namespace contains the following constants:

      .. oe:constant:: Default

   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::CSV

      This namespace contains constants for modifying the behavior of
      how the :oe:const:`OEChem::OEFormat::CSV` file format is written.

      .. seealso::

         :ref:`section_moltaggeddata_CSV`

      .. oe:constant:: Header

         This flag indicates whether the first line in the
         :file:`.csv` should contain the column names for the
         file. Column names are determined by the SD data present on
         the first molecule written to the
         :ref:`oemolostream <OEChem_oemolostream>`, regardless of whether this
         flag is set. The column names are retrievable through the
         :oe:meth:`OEChem::oemolstreambase::GetCSVHeader` method on the
         :ref:`OECSVHeader <OEChem_OECSVHeader>` object.

         If this flag is not set, the first line of the
         output :file:`.csv` file will be the first molecule record.

      .. oe:constant:: Default

         Set to include :oe:const:`OEChem::OEOFlavor::CSV::Header` to
         automatically write the column names as the first line in the
         file.

      .. oe:constant:: DEFAULT

         Synonym for :oe:const:`OEChem::OEOFlavor::CSV::Default`.

   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::CXSMILES

      The :oe:constns:`OEChem::OEOFlavor::CXSMILES` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OECreateSmiString` function
      when writing a molecule into a :oe:const:`OEChem::OEFormat::CXSMILES`
      format file.

      .. note::

         If no aromaticity model is specified for the
         :oe:constns:`OEChem::OEOFlavor::Generic` namespace for this file format,
         then the OpenEye  model is used by default to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      This namespace contains the following constants:

      .. oe:constant:: AllBonds

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AllBonds` constant.

      .. oe:constant:: AtomMaps

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AtomMaps` constant.

      .. oe:constant:: AtomStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AtomStereo` constant.

      .. oe:constant:: BondStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::BondStereo` constant.

      .. oe:constant:: Canonical

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Canonical` constant.

      .. oe:constant:: DEFAULT

         Same as the :oe:const:`OEChem::OEOFlavor::CXSMILES::Default` constant.

      .. oe:constant:: Default

         Combination of
         :oe:const:`OEChem::OEOFlavor::CXSMILES::AtomMaps`,
         :oe:const:`OEChem::OEOFlavor::CXSMILES::AtomStereo`,
         :oe:const:`OEChem::OEOFlavor::CXSMILES::BondStereo`,
         :oe:const:`OEChem::OEOFlavor::CXSMILES::Canonical`,
         :oe:const:`OEChem::OEOFlavor::CXSMILES::Isotopes`,
         :oe:const:`OEChem::OEOFlavor::CXSMILES::RGroups` and
         :oe:const:`OEChem::OEOFlavor::CXSMILES::EnhStereo` flags.

      .. oe:constant:: EnhStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::EnhStereo` constant.

      .. oe:constant:: ExtBonds

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::ExtBonds` constant.

      .. oe:constant:: Hydrogens

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Hydrogens` constant.

      .. oe:constant:: ImpHCount

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::ImpHCount` constant.

      .. oe:constant:: Isotopes

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Isotopes` constant.

      .. oe:constant:: Kekule

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Kekule` constant.

      .. oe:constant:: RGroups

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::RGroups` constant.

      .. oe:constant:: SmiMask

      .. oe:constant:: SuperAtoms

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::SuperAtoms` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::FASTA

      This namespace contains the following constants:

      .. oe:constant:: Default


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::Generic

      This namespace contains the following constants:

      .. oe:constant:: OEAroModelDaylight

         This flag indicates that the Daylight aromaticity model is
         used to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      .. oe:constant:: OEAroModelOpenEye

         This flag indicates that the OpenEye aromaticity model is
         used to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      .. oe:constant:: OEAroModelTripos

         This flag indicates that the Tripos aromaticity model is
         used to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      .. oe:constant:: OEAroModelMMFF

         This flag indicates that the MMFF aromaticity model is
         used to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      .. oe:constant:: OEAroModelMDL

         This flag indicates that the MDL aromaticity model is
         used to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      .. oe:constant:: AroMask

         Combination of
         :oe:const:`OEChem::OEOFlavor::Generic::OEAroModelDaylight`,
         :oe:const:`OEChem::OEOFlavor::Generic::OEAroModelOpenEye`,
         :oe:const:`OEChem::OEOFlavor::Generic::OEAroModelTripos`,
         :oe:const:`OEChem::OEOFlavor::Generic::OEAroModelMMFF` and
         :oe:const:`OEChem::OEOFlavor::Generic::OEAroModelMDL` flags.

         .. seealso::

            * :ref:`section_aromaticity_models` section
            * :oe:func:`OEChem::OEAssignAromaticFlags` function

      .. oe:constant:: Rings

         This flag indicates the rings are (re)perceived by the
         :oe:func:`OEChem::OEWriteMolecule` high-level reader by calling
         the :oe:func:`OEChem::OEFindRingAtomsAndBonds` function.

      .. oe:constant:: GenericMask

         Combination of
         :oe:const:`OEChem::OEIFlavor::Generic::AroMask` and
         :oe:const:`OEChem::OEIFlavor::Generic::Rings` flags.

      .. oe:constant:: SpecificMask

      .. oe:constant:: DEFAULT

      .. oe:constant:: Default

         Same as the :oe:const:`OEChem::OEOFlavor::Generic::DEFAULT` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::INCHI

      The :oe:constns:`OEChem::OEOFlavor::INCHI` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OECreateInChI` function
      when writing a molecule into the :oe:const:`OEChem::OEFormat::INCHI`
      format file.
      These constants translate into InChI library options documented
      in the `InChI API Reference`_ documentation.

      .. seealso::

         :ref:`OEInChIOptions <OEChem_OEInChIOptions>`

      This namespace contains the following constants:

      .. oe:constant:: Chiral

         Corresponds to the ``ChiralFlagOn`` InChI option.

      .. oe:constant:: Default

         Equal to :oe:const:`OEChem::OEOFlavor::INCHI::Stereo` and :oe:const:`OEChem::OEOFlavor::INCHI::Title`.

      .. oe:constant:: FixedHLayer

         Corresponds to the ``FixedH`` InChI option.

      .. oe:constant:: Hydrogens

         Corresponds to the inverse of the ``DoNotAddH`` InChI option.

      .. oe:constant:: RacemicStereo

         Corresponds to the ``SRac`` InChI option.

      .. oe:constant:: ReconnectedMetals

         Corresponds to the ``RecMet`` InChI option.

      .. oe:constant:: RelativeStereo

         Corresponds to the ``SRel`` InChI option.

      .. oe:constant:: Stereo

         Corresponds to the inverse of the ``SNon`` InChI option.

      .. oe:constant:: Title

         If this flag is set, then the molecule's title (returned by
         :oe:meth:`OEChem::OEMolBase::GetTitle` method) is written to
         the output file.

   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::INCHIKEY

      The :oe:constns:`OEChem::OEOFlavor::INCHIKEY` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OECreateInChIKey` function
      when writing a molecule into a :oe:const:`OEChem::OEFormat::INCHIKEY`
      format file.
      These constants translate into InChI library options documented
      in the `InChI API Reference`_ documentation.

      This namespace contains the following constants:

      .. oe:constant:: Chiral

         Corresponds to the ``ChiralFlagOn`` InChI option.

      .. oe:constant:: Default

         Equal to :oe:const:`OEChem::OEOFlavor::INCHIKEY::Stereo` and :oe:const:`OEChem::OEOFlavor::INCHIKEY::Title`.

      .. oe:constant:: FixedHLayer

         Corresponds to the ``FixedH`` InChI option.

      .. oe:constant:: Hydrogens

         Corresponds to the inverse of the ``DoNotAddH`` InChI option.

      .. oe:constant:: RacemicStereo

         Corresponds to the ``SRac`` InChI option.

      .. oe:constant:: ReconnectedMetals

         Corresponds to the ``RecMet`` InChI option.

      .. oe:constant:: RelativeStereo

         Corresponds to the ``SRel`` InChI option.

      .. oe:constant:: Stereo

         Corresponds to the inverse of the ``SNon`` InChI option.

      .. oe:constant:: Title

         If this flag is set, then the molecule's title (returned by
         :oe:meth:`OEChem::OEMolBase::GetTitle` method) is written to
         the output file.

   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::ISM

      The :oe:constns:`OEChem::OEOFlavor::ISM` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OECreateSmiString` function
      when writing a molecule into a :oe:const:`OEChem::OEFormat::ISM`
      format file.

      .. note::

         If no aromaticity model is specified for the
         :oe:constns:`OEChem::OEOFlavor::Generic` namespace for this file format,
         then the OpenEye  model is used by default to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      This namespace contains the following constants:

      .. oe:constant:: AllBonds

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AllBonds` constant.

      .. oe:constant:: AtomMaps

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AtomMaps` constant.

      .. oe:constant:: AtomStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AtomStereo` constant.

      .. oe:constant:: BondStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::BondStereo` constant.

      .. oe:constant:: Canonical

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Canonical` constant.

      .. oe:constant:: DEFAULT

         Same as the :oe:const:`OEChem::OEOFlavor::ISM::Default` constant.

      .. oe:constant:: Default

         Combination of
         :oe:const:`OEChem::OEOFlavor::ISM::AtomMaps`,
         :oe:const:`OEChem::OEOFlavor::ISM::AtomStereo`,
         :oe:const:`OEChem::OEOFlavor::ISM::BondStereo`,
         :oe:const:`OEChem::OEOFlavor::ISM::Canonical`,
         :oe:const:`OEChem::OEOFlavor::ISM::Isotopes` and
         :oe:const:`OEChem::OEOFlavor::ISM::RGroups` flags.

      .. oe:constant:: EnhStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::EnhStereo` constant.

      .. oe:constant:: ExtBonds

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::ExtBonds` constant.

      .. oe:constant:: Hydrogens

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Hydrogens` constant.

      .. oe:constant:: ImpHCount

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::ImpHCount` constant.

      .. oe:constant:: Isotopes

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Isotopes` constant.

      .. oe:constant:: Kekule

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Kekule` constant.

      .. oe:constant:: RGroups

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::RGroups` constant.

      .. oe:constant:: SmiMask

      .. oe:constant:: SuperAtoms

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::SuperAtoms` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::MDL

      The :oe:constns:`OEChem::OEOFlavor::MDL` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OEWriteMDLFile` and the
      :oe:func:`OEChem::OEWriteMolecule` functions
      when writing a molecule into a :oe:const:`OEChem::OEFormat::MDL`
      format file.

      This namespace contains the following constants:

      .. oe:constant:: Add2D

         This flag indicates that if a molecule has no coordinates, then
         2D coordinates are generated prior to  writing a molecule by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.
         If the molecule already has 2D or 3D coordinates
         then these coordinates are left intact.
         In certain cases the 2D layout may result in incorrect stereochemistry
         in the resulting connection table.  In these cases no coordinates
         are generated.

      .. oe:constant:: UnsetBad2DStereo

         This flag is used with the Add2D constant.  In certain cases
         the 2D layout may result in incorrect stereochemistry in the output
         connection table format.  When this flag is set the writer will
         output the generated coordinates and set the stereochemistry of the
         offending stereocenters to 'Undefined'.

      .. oe:constant:: MCHG

         The :oe:const:`OEChem::OEOFlavor::MDL::MCHG` flag is used to instruct
         the MDL mol file writer to write ``M CHG`` and ``M RAD`` lines for
         charged/radical atoms in the output connection table, even if the
         charge and radical values of every atom are within the ranges
         representable by the MDL atom block.  By default, ``M CHG`` and ``M
         RAD`` lines are only used for connection tables that 'overflow' the
         allowed atom block limits.

      .. oe:constant:: MISO

         The :oe:const:`OEChem::OEOFlavor::MDL::MISO` flag is used to instruct
         the **OEChem TK** MDL mol file writer to write ``M ISO`` lines for isotopes
         in the output connection table, even if the isotopic masses of every
         atom are within the range representable by the MDL atom block.  By
         default, ``M ISO`` lines are only used for connection tables that
         'overflow' the allowed atom block limits.

      .. oe:constant:: MRGP

         The :oe:const:`OEChem::OEOFlavor::MDL::MRGP` flag is used to instruct
         the **OEChem TK** MDL mol file writer to write out ``M RGP`` entries for
         each R-group atom, *i.e.* atom with element zero and a non-zero atom
         map index.  These atoms are always written with atomic symbol ``R#``.

      .. oe:constant:: MV30

         Force every molecule to be written in V3000 format. By
         default, only molecules with more than 999 atoms or enhanced
         stereo groups will be written in V3000 format.

      .. oe:constant:: MDLParity

         If this flag is set and :oe:func:`OEChem::OEMDLHasParity`
         returns ``false`` ,then :oe:func:`OEChem::OEMDLPerceiveParity`
         function is called to perceive the MDL atom stereo parity
         fields.

         .. note::

            This flag is only interpreted by the high-level file writers
            (:oe:func:`OEChem::OEWriteMolecule`) and not in
            :oe:func:`OEChem::OEWriteMDLFile`.

      .. oe:constant:: NoParity

         If this flag is set, then :oe:func:`OEChem::OEMDLClearParity`
         function is called to set all MDL atom stereo parity fields
         to zero.

         .. note::

            This flag is only interpreted by the high-level file writers
            (:oe:func:`OEChem::OEWriteMolecule`) and not in
            :oe:func:`OEChem::OEWriteMDLFile`.

      .. oe:constant:: CurrentParity

         If this flag is set, then the MDL atom stereo parity fields
         are left intact.

         .. note::

            This flag is only interpreted by the high-level file writers
            (:oe:func:`OEChem::OEWriteMolecule`) and not in
            :oe:func:`OEChem::OEWriteMDLFile`.

      .. oe:constant:: MMask

      .. oe:constant:: PMask

         Combination of
         :oe:const:`OEChem::OEOFlavor::MDL::MDLParity`,
         :oe:const:`OEChem::OEOFlavor::MDL::NoParity` and
         :oe:const:`OEChem::OEOFlavor::MDL::CurrentParity` flags.
         The flag controls the processing of the MDL stereo parity bit
         field of each atom.

      .. oe:constant:: SuppressImp2ExpENHSTE

         This flavor suppresses any implicit to explicit enhanced stereogroup
         conversions if the output is V3000 format.

      .. oe:constant:: SuppressTimestamps

         This flavor suppresses the output of timestamps in MDL format header line(s).
         This can be useful for generation of simple diffable standards for use in tests.

      .. oe:constant:: DEFAULT

         Combination of
         :oe:const:`OEChem::OEOFlavor::MDL::Add2D`,
         :oe:const:`OEChem::OEOFlavor::MDL::MDLParity`,
         :oe:const:`OEChem::OEOFlavor::MDL::MRGP`,
         :oe:const:`OEChem::OEOFlavor::MDL::MISO` and
         :oe:const:`OEChem::OEOFlavor::MDL::MCHG` flags.

      .. oe:constant:: Default

         Same as the :oe:const:`OEChem::OEOFlavor::MDL::DEFAULT` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::MF

      The :oe:constns:`OEChem::OEOFlavor::MF` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OEWriteMolecule` functions
      when writing a molecule into a :oe:const:`OEChem::OEFormat::MF`
      format file.

      This namespace contains the following constants:

      .. oe:constant:: Title

         If this flag is set, then the molecule's title (returned by
         :oe:meth:`OEChem::OEMolBase::GetTitle` method) is written to
         the output file.

      .. oe:constant:: DEFAULT

         Same as the :oe:const:`OEChem::OEOFlavor::MF::Title` constant.

      .. oe:constant:: Default

         Same as the :oe:const:`OEChem::OEOFlavor::MF::DEFAULT` constant.


   .. ################################################################
      #
      ################################################################

..  _OEChem_OEOFlavor_MMCIF:

   .. oe:constnamespace:: OEOFlavor::MMCIF

      .. note::

         If no aromaticity model is specified for the
         :oe:constns:`OEChem::OEOFlavor::Generic` namespace for this file format,
         then the OpenEye model is used by default to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      This namespace contains the following constants:

..  _OEChem_OEOFlavor_MMCIF_PerceiveMetadata:

      .. oe:constant:: PerceiveMetadata

..  _OEChem_OEOFlavor_MMCIF_PerceiveMetadata_Default:

      .. oe:constant:: Default

   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::MMOD

      This namespace contains following constants:

      .. oe:constant:: AtomTypes

      .. oe:constant:: DEFAULT

      .. oe:constant:: Default

         Same as the :oe:const:`OEChem::OEOFlavor::MMOD::DEFAULT` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::MOL2

      .. note::

         Except for MOL2 Flavor Forcefield, if no aromaticity model is specified for the
         :oe:constns:`OEChem::OEOFlavor::Generic` namespace for this file format,
         then the Tripos model is used by default to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      This namespace contains the following constant:

      .. oe:constant:: AtomNames

      .. oe:constant:: AtomTypeNames

      .. oe:constant:: BondTypeNames

      .. oe:constant:: ChargePrecision

         This flavor allows for increased precision of partial charges by writing
         them out to 5 decimal places.

      .. oe:constant:: Forcefield

         Combination of
         :oe:const:`OEChem::OEOFlavor::MOL2::GeneralFFFormat`,
         :oe:const:`OEChem::OEOFlavor::MOL2::ChargePrecision`, and
         :oe:const:`OEChem::OEOFlavor::MOL2::BondTypeNames` flags

         This variant of MOL2 reflects a common use of MOL2 format to embody
         information for a general forcefield. It combines the :oe:const:`OEChem::OEOFlavor::MOL2::GeneralFFFormat`
         so that atom names, atom types, and atom ordering are written out "as is"
         based on the input molecule, and :oe:const:`OEChem::OEOFlavor::MOL2::ChargePrecision`, which writes out
         atomic partial charges to 5 decimal places. Mol2 :oe:const:`OEChem::OEOFlavor::MOL2::BondTypeNames` are
         retained from the Tripos standard at this point because they are
         generally reasonable and historically they don't conflict with the
         other needs of general forcefield format.

      .. oe:constant:: GeneralFFFormat

         This variant of MOL2 is commonly used for carrying information for
         force fields more general than the Tripos forcefield (the MOL2 standard).
         Here the atom names, atom types, and atom ordering are retained from the
         input molecule, rather than being changed to comply with
         the Tripos MOL2 standard. If an atom does not have a user-defined atom name
         and atom type for all atoms, warnings will be given and no molecule will
         be written.

      .. oe:constant:: Hydrogens

      .. oe:constant:: OrderAtoms

      .. oe:constant:: Substructure

      .. oe:constant:: NameMask

      .. oe:constant:: AllMask

      .. oe:constant:: DEFAULT

      .. oe:constant:: Default

         Same as the :oe:const:`OEChem::OEOFlavor::MOL2::DEFAULT` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::MOL2H

      .. note::

         If no aromaticity model is specified for the
         :oe:constns:`OEChem::OEOFlavor::Generic` namespace for this file format,
         then the Tripos model is used by default to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      This namespace contains the following constants:

      .. oe:constant:: AtomTypeNames

      .. oe:constant:: BondTypeNames

      .. oe:constant:: AtomNames

      .. oe:constant:: OrderAtoms

      .. oe:constant:: Hydrogens

      .. oe:constant:: Substructure

      .. oe:constant:: NameMask

      .. oe:constant:: AllMask

      .. oe:constant:: DEFAULT

      .. oe:constant:: Default

         Same as the :oe:const:`OEChem::OEOFlavor::MOL2H::DEFAULT` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::MOPAC

      This namespace contains the following constants:

      .. oe:constant:: XYZ

      .. oe:constant:: CHARGES

      .. oe:constant:: AllMask

      .. oe:constant:: DEFAULT

      .. oe:constant:: Default

         Same as the :oe:const:`OEChem::OEOFlavor::MOPAC::DEFAULT` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::OEB

      This namespace contains the following constants:

      .. oe:constant:: Default

   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::OEZ

      This namespace contains the following constants:

      .. oe:constant:: Default

   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::PDB

      The :oe:constns:`OEChem::OEOFlavor::PDB` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OEWritePDBFile` and the
      :oe:func:`OEChem::OEWriteMolecule` functions
      when writing a molecule into a :oe:const:`OEChem::OEFormat::PDB`
      format file.

      This namespace contains the following constants:

      .. oe:constant:: BONDS

         Controls whether the OEChem PDB file writer includes `CONECT`_
         records to describe the connectivity of the molecule.  If this flag is
         given without :oe:const:`OEChem::OEOFlavor::PDB::ORDERS` all bonds are
         written as 'single' bonds.  :oe:const:`OEChem::OEOFlavor::PDB::BONDS` is
         off by default.

      .. oe:constant:: ORDERS

         Controls whether the PDB file writer should use repeated `CONECT`_
         records to represent multiple bond orders (*i.e.* double and triple
         bonds).  If this flag is given without
         :oe:const:`OEChem::OEOFlavor::PDB::BONDS` only double and triple bonds are
         written to the file. :oe:const:`OEChem::OEOFlavor::PDB::ORDERS` is off by
         default.

      .. oe:constant:: BOTH

         Including this bit-mask writes bi-directional `CONECT`_ records.
         Conventionally, PDB files list connect records both from source atom
         to destination atom, and again from destination to source.  This
         duplication doubles the number/size of `CONECT`_ records with
         redundant information, as most readers (if they honor `CONECT`_
         records at all) can work with uni-directional `CONECT`_ records.
         By default, this flavor is enabled and bi-directional `CONECT`_ records
         are written.

      .. oe:constant:: CHARGE

         Controls whether the PDB file writer takes the value for the PDB
         file's B-factor field from the atom's partial charge property.  A
         number of applications, including Delphi, (ab)use the PDB file format
         specification to store atomic partial charges in the b-factor field
         rather instead of crystallographically determined anisotropic
         temperature factors.  :oe:const:`OEChem::OEOFlavor::PDB::CHARGE` is off by
         default.

      .. oe:constant:: RADIUS

         Controls whether the PDB file writer takes the value for the PDB
         file's occupancy field from the atom's radius property.  A number of
         applications, including Delphi, (ab)use the PDB file format
         specification to store radii in the occupancy field rather instead of
         crystallographically determined anisotropic
         occupancies. :oe:const:`OEChem::OEOFlavor::PDB::RADIUS` is off by default.

      .. oe:constant:: TER

         Controls whether the PDB file writer terminates each connection table
         with a `TER`_ record rather than an `END`_ record.  Some dubious
         molecular graphics software, such as Grasp, requires that multiple
         compounds be separated by the chain/fragment separator `TER`_, rather
         than the molecule separator `END`_.
         :oe:const:`OEChem::OEOFlavor::PDB::TER` is off by default.

      .. oe:constant:: DELPHI

         Combination of :oe:const:`OEChem::OEOFlavor::PDB::CHARGE` and
         :oe:const:`OEChem::OEOFlavor::PDB::RADIUS` flags.

      .. oe:constant:: ELEMENT

         Controls whether the PDB writer writes the chemical symbol
         right-justified in columns 77-78, as specified by version 2.2 of the
         PDB format specification.  :oe:const:`OEChem::OEOFlavor::PDB::ELEMENT` is on by default.

      .. oe:constant:: FORMALCHARGE

         Controls whether the PDB file writer writes the formal charge
         right-justified (*e.g.* ``2+``, ``2-``) in columns 79-80, as specified
         by version 2.2 of the PDB format specification.  This flag is off by default.  Enabling
         :oe:const:`OEChem::OEOFlavor::PDB::FORMALCHARGE` also enables
         :oe:const:`OEChem::OEOFlavor::PDB::ELEMENT`.

      .. oe:constant:: HETBONDS

         Controls whether the PDB writer writes any bond to or from a
         'hetero atom' (i.e. atom that has the record type ``HETATM`` in a
         PDB file). :oe:const:`OEChem::OEOFlavor::PDB::HETBONDS` is on by default.

         .. seealso::

            * :oe:constns:`OEChem::OEPreserveResInfo` namespace
            * :oe:meth:`OEChem::OEResidue::IsHetAtom` method to retrieve the 'hetero atom' property of an atom in a residue
            * :oe:meth:`SetHetAtom<OEChem::OEResidue::SetHetAtom>` method


      .. oe:constant:: BasicMask

      .. oe:constant:: OEResidues

         .. note::

            This flag is only interpreted by the high-level file
            writers (:oe:func:`OEChem::OEWriteMolecule`) and not in
            :oe:func:`OEChem::OEWritePDBFile`.

      .. oe:constant:: NoResidues

         .. note::

            This flag is only interpreted by the high-level file
            writers (:oe:func:`OEChem::OEWriteMolecule`) and not in
            :oe:func:`OEChem::OEWritePDBFile`.

      .. oe:constant:: CurrentResidues

         .. note::

            This flag is only interpreted by the high-level file
            writers (:oe:func:`OEChem::OEWriteMolecule`) and not in
            :oe:func:`OEChem::OEWritePDBFile`.

      .. oe:constant:: OrderAtoms

         .. note::

            This flag is only interpreted by the high-level file
            writers (:oe:func:`OEChem::OEWriteMolecule`) and not in
            :oe:func:`OEChem::OEWritePDBFile`.

      .. oe:constant:: AllMask

      .. oe:constant:: DEFAULT

         Combination of
         :oe:const:`OEChem::OEOFlavor::PDB::OrderAtoms`,
         :oe:const:`OEChem::OEOFlavor::PDB::OEResidues`,
         :oe:const:`OEChem::OEOFlavor::PDB::HETBONDS`,
         :oe:const:`OEChem::OEOFlavor::PDB::ELEMENT` and
         :oe:const:`OEChem::OEOFlavor::PDB::BOTH` flags.

      .. oe:constant:: Default

         Same as the :oe:const:`OEChem::OEOFlavor::PDB::DEFAULT` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace: OEOFlavor::RDF IGNORED

      This namespace contains the following constants:

      .. oe:constant:: MCHG

      .. oe:constant:: MISO

      .. oe:constant:: MRGP

      .. oe:constant:: MV30

      .. oe:constant:: MDLParity

      .. oe:constant:: NoParity

      .. oe:constant:: CurrentParity

      .. oe:constant:: MMask

      .. oe:constant:: PMask

      .. oe:constant:: SuppressImp2ExpENHSTE

      .. oe:constant:: DEFAULT

      .. oe:constant:: Default


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::SDF

      The :oe:constns:`OEChem::OEOFlavor::SDF` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OEWriteMDLFile` and the
      :oe:func:`OEChem::OEWriteMolecule` functions
      when writing a molecule into a :oe:const:`OEChem::OEFormat::SDF`
      format file.

      This namespace contains the following constants:

      .. oe:constant:: Add2D

         This flag indicates that if a molecule has no coordinates, then
         2D coordinates are generated prior to  writing a molecule by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.
         If the molecule already has 2D or 3D coordinates
         then these coordinates are left intact.
         In certain cases the 2D layout may result in incorrect stereochemistry
         in the resulting connection table.  In these cases no coordinates
         are generated.

      .. oe:constant:: UnsetBad2DStereo

         This flag is used with the Add2D constant.  In certain cases
         the 2D layout may result in incorrect stereochemistry in the output
         connection table format.  When this flag is set the writer will
         output the generated coordinates and set the stereochemistry of the
         offending stereocenters to 'Undefined'.

      .. oe:constant:: MCHG

      .. oe:constant:: MISO

      .. oe:constant:: MRGP

      .. oe:constant:: MV30

      .. oe:constant:: MDLParity

         If this flag is set and :oe:func:`OEChem::OEMDLHasParity`
         returns ``false`` ,then :oe:func:`OEChem::OEMDLPerceiveParity`
         function is called to perceive the MDL atom stereo parity
         fields.

         .. note::

            This flag is only interpreted by the high-level file writers
            (:oe:func:`OEChem::OEWriteMolecule`) and not in
            :oe:func:`OEChem::OEWriteMDLFile`.

      .. oe:constant:: NoParity

         If this flag is set, then :oe:func:`OEChem::OEMDLClearParity`
         function is called to set all MDL atom stereo parity fields
         to zero.

         .. note::

            This flag is only interpreted by the high-level file writers
            (:oe:func:`OEChem::OEWriteMolecule`) and not in
            :oe:func:`OEChem::OEWriteMDLFile`.

      .. oe:constant:: CurrentParity

         If this flag is set, then the MDL atom stereo parity fields
         are left intact.

         .. note::

            This flag is only interpreted by the high-level file writers
            (:oe:func:`OEChem::OEWriteMolecule`) and not in
            :oe:func:`OEChem::OEWriteMDLFile`.

      .. oe:constant:: MMask

      .. oe:constant:: PMask

         Combination of
         :oe:const:`OEChem::OEOFlavor::SDF::MDLParity`,
         :oe:const:`OEChem::OEOFlavor::SDF::NoParity` and
         :oe:const:`OEChem::OEOFlavor::SDF::CurrentParity` flags.
         The flag controls the processing of the MDL stereo parity bit
         field of each atom.

      .. oe:constant:: SuppressImp2ExpENHSTE

         This flavor suppresses any implicit to explicit enhanced stereogroup
         conversions if the output is V3000 format.

      .. oe:constant:: SuppressTimestamps

         This flavor suppresses the output of timestamps in MDL format header line(s).
         This can be useful for generation of simple diffable standards for use in tests.

      .. oe:constant:: DEFAULT

         Combination of
         :oe:const:`OEChem::OEOFlavor::SDF::Add2D`,
         :oe:const:`OEChem::OEOFlavor::SDF::MDLParity`,
         :oe:const:`OEChem::OEOFlavor::SDF::MRGP`,
         :oe:const:`OEChem::OEOFlavor::SDF::MISO` and
         :oe:const:`OEChem::OEOFlavor::SDF::MCHG` flags.

      .. oe:constant:: Default

         Same as the :oe:const:`OEChem::OEOFlavor::SDF::DEFAULT` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace: OEOFlavor::SKC IGNORED

      This namespace contains the following constants:

      .. oe:constant:: Default


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::SLN

      .. note::

         If no aromaticity model is specified for the
         :oe:constns:`OEChem::OEOFlavor::Generic` namespace for this file format,
         then the Tripos model is used by default to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      This namespace contains the following constants:

      .. oe:constant:: Default


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::SMI

      The :oe:constns:`OEChem::OEOFlavor::SMI` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OECreateSmiString` function
      when writing a molecule into a :oe:const:`OEChem::OEFormat::SMI`
      format file.

      .. note::

         If no aromaticity model is specified for the
         :oe:constns:`OEChem::OEOFlavor::Generic` namespace for this file format,
         then the OpenEye  model is used by default to perceive aromaticity by the
         :oe:func:`OEChem::OEWriteMolecule` high-level writer.

      This namespace contains the following constants:

      .. oe:constant:: AllBonds

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AllBonds` constant.

      .. oe:constant:: AtomMaps

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AtomMaps` constant.

      .. oe:constant:: AtomStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AtomStereo` constant.

      .. oe:constant:: BondStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::BondStereo` constant.

      .. oe:constant:: Canonical

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Canonical` constant.

      .. oe:constant:: DEFAULT

         Same as the :oe:const:`OEChem::OEOFlavor::SMI::Default` constant.

      .. oe:constant:: Default

         Combination of
         :oe:const:`OEChem::OEOFlavor::SMI::AtomMaps`,
         :oe:const:`OEChem::OEOFlavor::SMI::AtomStereo`,
         :oe:const:`OEChem::OEOFlavor::SMI::BondStereo`,
         :oe:const:`OEChem::OEOFlavor::SMI::Canonical`,
         :oe:const:`OEChem::OEOFlavor::SMI::Isotopes` and
         :oe:const:`OEChem::OEOFlavor::SMI::RGroups` flags.

      .. oe:constant:: EnhStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::EnhStereo` constant.

      .. oe:constant:: ExtBonds

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::ExtBonds` constant.

      .. oe:constant:: Hydrogens

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Hydrogens` constant.

      .. oe:constant:: ImpHCount

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::ImpHCount` constant.

      .. oe:constant:: Isotopes

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Isotopes` constant.

      .. oe:constant:: Kekule

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Kekule` constant.

      .. oe:constant:: RGroups

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::RGroups` constant.

      .. oe:constant:: SmiMask

      .. oe:constant:: SuperAtoms

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::SuperAtoms` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::USM

      This namespace contains constants.

      .. oe:constant:: AllBonds

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AllBonds` constant.

      .. oe:constant:: AtomMaps

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AtomMaps` constant.

      .. oe:constant:: AtomStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::AtomStereo` constant.

      .. oe:constant:: BondStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::BondStereo` constant.

      .. oe:constant:: Canonical

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Canonical` constant.

      .. oe:constant:: DEFAULT

         Same as the :oe:const:`OEChem::OEOFlavor::USM::Default` constant.

      .. oe:constant:: Default

         Combination of
         :oe:const:`OEChem::OEOFlavor::USM::AtomMaps`,
         :oe:const:`OEChem::OEOFlavor::USM::RGroups` flags.

      .. oe:constant:: EnhStereo

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::EnhStereo` constant.

      .. oe:constant:: ExtBonds

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::ExtBonds` constant.

      .. oe:constant:: Hydrogens

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Hydrogens` constant.

      .. oe:constant:: ImpHCount

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::ImpHCount` constant.

      .. oe:constant:: Isotopes

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Isotopes` constant.

      .. oe:constant:: Kekule

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::Kekule` constant.

      .. oe:constant:: RGroups

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::RGroups` constant.

      .. oe:constant:: SmiMask

      .. oe:constant:: SuperAtoms

         Corresponds to the :oe:const:`OEChem::OESMILESFlag::SuperAtoms` constant.


   .. ################################################################
      #
      ################################################################

   .. oe:constnamespace:: OEOFlavor::XYZ

      The :oe:constns:`OEChem::OEOFlavor::XYZ` namespace encodes symbolic
      constants used as bit-masks that control the processing
      performed by the :oe:func:`OEChem::OEWriteXYZFile` function
      when writing a molecule into a :oe:const:`OEChem::OEFormat::XYZ`
      format file.

      This namespace contains the following constants:

      .. oe:constant:: Charges

         Specifies that the partial charge for each atom should be
         appended as an additional column.

      .. oe:constant:: Symbols

         Write the atomic symbol instead of the atomic number.

      .. oe:constant:: SinglePrecision

         Forces coordinates to be written in single precision with only 5
         significant digits.

      .. oe:constant:: DoublePrecision

         Forces coordinates to be written in double precision with only 18
         significant digits.

      .. oe:constant:: Default

         Equivalent to ``Charges | Symbols``. By default, what
         precision, single or double precision will be introspected
         from the molecule type.
