.. _section_example_oechem_cansmi:

Generate canonical SMILES
================================================================================

A program that generates the canonical SMILES of the molecules in the
input file. It has a number of options such as ``-from3d``, which
perceives stereo from the 3D coordinates, ``-isomeric``, which
produces the canonical isomeric SMILES, and ``-kekule``, which
produces the Kekulé SMILES form.

Example
--------------------------------------------------------------------------------

.. oe:language:: c++

   .. code-block:: console

      prompt> cansmi dbase.oeb.gz output.smi
      prompt> cansmi -from3d true -i dbase.sdf -o output.smi

.. oe:language:: python

   .. code-block:: console

      prompt> cansmi.py dbase.oeb.gz output.smi
      prompt> cansmi.py  -from3d true -i dbase.sdf -o output.smi

.. oe:language:: java

   .. code-block:: console

      prompt> CanSmi dbase.oeb.gz output.smi
      prompt> CanSmi -from3d true -i dbase.sdf -o output.smi

.. oe:language:: csharp

   .. code-block:: console

      prompt> CanSmi dbase.oeb.gz output.smi
      prompt> CanSmi -from3d -i dbase.sdf -o output.smi

Code
--------------------------------------------------------------------------------

.. oe:language:: c++

   .. only:: oehtml

      .. admonition:: Download code

         :download:`cansmi.cpp <../../../../../sublibs/tklibs/oechem/examples/cansmi.cpp>`

   .. only:: oepdf

      .. oe:source:: cansmi.cpp
         :language: c++

.. oe:language:: python

   .. only:: oehtml

      .. admonition:: Download code

         :download:`cansmi.py <../../../../../wrappers/python/examples/oechem/cansmi.py>`

      .. literalinclude:: ../../../../../wrappers/python/examples/oechem/cansmi.py


   .. only:: oepdf

      .. oe:source:: cansmi.py
         :language: python

.. oe:language:: java

   .. only:: oehtml

      .. admonition:: Download code

         :download:`CanSmi.java <../../../../../wrappers/java/examples/openeye/examples/oechem/CanSmi.java>`

   .. only:: oepdf

      .. oe:source:: CanSmi.java
         :language: java

.. oe:language:: csharp

   .. only:: oehtml

      .. admonition:: Download code

         :download:`CanSmi.cs <../../../../../wrappers/csharp/Csharp-Examples/OEChem/CanSmi.cs>`

   .. only:: oepdf

      .. oe:source:: CanSmi.cs
         :language: csharp

.. seealso::

   * :oe:func:`OEChem::OEFindRingAtomsAndBonds` function
   * :oe:func:`OEChem::OEAssignAromaticFlags` function
   * :oe:func:`OEChem::OEKekulize` function
   * :oe:func:`OEChem::OECanonicalOrderAtoms` function
   * :oe:func:`OEChem::OECanonicalOrderBonds` function
