
.. oe:namespace:: OEChem

..  _oechem_OEFormat:

.. oe:constnamespace:: OEFormat

   The OEFormat namespace encodes symbolic constants
   representing the molecular file formats that may be read or written
   by **OEChem TK**.

   .. seealso::

      * :ref:`section_molreadwrite_fileformats` section

   This namespace contains the following constants:

   .. oe:constant:: Default

      The default file format type is :oe:const:`OEChem::OEFormat::SMI`.

   .. oe:constant:: CAN

      This constant indicates :term:`Canonical SMILES`  file format.

   .. oe:constant:: CDX

      This constant indicates ChemDraw CDX file format.

   .. oe:constant:: CIF

      This constant indicates the small molecule Crystallographic Information File (CIF) format.

   .. oe:constant:: CSV

      This constant indicates the comma separated values file format
      as specified by `RFC 4180
      <http://tools.ietf.org/html/rfc4180>`_. The first column is
      :term:`canonical isomeric SMILES`, the second column is the
      :oe:meth:`molecule title<OEChem::OEMolBase::GetTitle>`, the
      remaining columns are SD data as determined by the first
      molecule read or written to the :ref:`oemolstreambase <OEChem_oemolstreambase>`.

      .. seealso::

         :ref:`section_moltaggeddata_CSV`

   .. oe:constant:: CXSMILES

      This constant indicates the Chemaxon Extended SMILES format.

      Enhanced stereogroup information is the only information in cxsmiles appendices currently supported.
      Please contact support@eyesopen.com if there are additional cxsmiles features that you would like to see supported.

      The specific features supported for this format are limited to,
      `MDL Chiral OFF 
      <https://docs.chemaxon.com/display/docs/formats_chemaxon-extended-smiles-and-smarts-cxsmiles-and-cxsmarts.md#molecule-absolute-stereoconfiguration>`_ and
      `Enhanced stereochemical representation 
      <https://docs.chemaxon.com/display/docs/formats_chemaxon-extended-smiles-and-smarts-cxsmiles-and-cxsmarts.md#enhanced-stereochemical-representation>`_ .
      The supported features cannot be in the presence of other unsupported features since a partial parse of the appendix information is disallowed.

      See `Chemaxon Extended SMILES and SMARTS <https://docs.chemaxon.com/display/docs/chemaxon-extended-smiles-and-smarts-cxsmiles-and-cxsmarts.md>`_ for a complete
      specification of all possible features.

   .. oe:constant:: FASTA

      This constant indicates FASTA protein sequence file format.

   .. oe:constant:: INCHI

      This constant indicates IUPAC InChI file format.

   .. oe:constant:: INCHIKEY

      This constant indicates IUPAC InChI Key file format.

   .. oe:constant:: ISM

      This constant indicates :term:`Canonical isomeric SMILES` file format.
      This is the same as the :oe:const:`OEChem::OEFormat::SMI` file format.

   .. oe:constant:: MAXFORMAT

      The maximum integral value any constant in the
      :oe:constns:`OEChem::OEFormat` can have.

      .. note::

         Values in this namespace are guaranteed to be contiguous.

   .. oe:constant:: MDL

      This constant indicates MDL Mol file format.

   .. oe:constant:: MF

      This constant indicates Molecular Formula  (Hill order) format.

   .. oe:constant:: MMCIF

      This constant indicates macromolecular Crystallographic Information File
      (mmCIF) file format.

   .. oe:constant:: MMOD

      This constant indicates Macromodel file format.

   .. oe:constant:: MOL2

      This constant indicates Tripos Sybyl mol2 file format.

   .. oe:constant:: MOL2H

      This constant indicates Tripos Sybyl mol2 file format with explicit hydrogens.

   .. oe:constant:: MOPAC

      This constant indicates MOPAC file format.

   .. oe:constant:: OEB

      This constant indicates **OpenEye** OEBinary file format.

   .. oe:constant:: OEZ

      This constant indicates Zstd compressed **OpenEye** OEBinary file format.
      Currently this file format **only** supports multi-conformer molecules derived
      from the :ref:`OEMCMolBase <OEChem_OEMCMolBase>` class.

      .. note::

         This file format was introduced in the ``2019.Apr`` toolkits.
         OpenEye applications or toolkits released before Apr/2019 will **not**
         be able to read this new file format.

      .. seealso::

         * :ref:`section_molreadwrite_compressed` section

   .. oe:constant:: PDB

      This constant indicates  Protein Databank PDB file format.

   .. oe:constant:: RDF

      This constant indicates MDL RDF reaction file format.

   .. oe:constant:: SDF

      This constant indicates MDL SD file format.

   .. oe:constant:: SKC

      This constant indicates MDL ISIS Sketch file format.

   .. oe:constant:: SLN

      This constant indicates Tripos Sybyl Line Notation file format.

   .. oe:constant:: SMI

      This constant indicates :term:`canonical isomeric SMILES` file format.
      This is the same as the :oe:const:`OEChem::OEFormat::ISM` file format.

   .. oe:constant:: UNDEFINED

      This constant indicates an unrecognized or undefined file format.

   .. oe:constant:: USM

      This constant indicates :term:`SMILES` file format.

   .. oe:constant:: XYZ

      This constant indicates XMol XYZ file format.
