.. _section_example_oechem_mcs3dalign:

Align molecules by maximum common substructure
================================================================================

A program that aligns a database of molecules with a reference
molecule based on the maximum common substructure (MCS) between the
reference and each query. The output file consists of the input
reference molecule and then each aligned database molecule.

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

.. oe:language:: c++

   .. code-block:: console

      prompt > mcs3dalign ligand.pdb dbase.oeb.gz output.oeb.gz

.. oe:language:: python

   .. code-block:: console

      prompt > mcs3dalign.py ligand.pdb dbase.oeb.gz output.oeb.gz

.. oe:language:: java

   .. code-block:: console

      prompt > MCS3DAlign ligand.pdb dbase.oeb.gz output.oeb.gz

.. oe:language:: csharp

   .. code-block:: console

      prompt > MCS3DAlign ligand.pdb dbase.oeb.gz output.oeb.gz


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

.. oe:language:: c++

   .. only:: oehtml

      .. admonition:: Download code

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

   .. only:: oepdf

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

.. oe:language:: python

   .. only:: oehtml

      .. admonition:: Download code

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

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


   .. only:: oepdf

      .. oe:source:: mcs3dalign.py
         :language: python

.. oe:language:: java

   .. only:: oehtml

      .. admonition:: Download code

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

   .. only:: oepdf

      .. oe:source:: MCS3DAlign.java
         :language: java

.. oe:language:: csharp

   .. only:: oehtml

      .. admonition:: Download code

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

   .. only:: oepdf

      .. oe:source:: MCS3DAlign.cs
         :language: csharp

.. seealso::

   * :ref:`OEMCSSearch <OEChem_OEMCSSearch>` class
   * :oe:func:`OEChem::OERotate` function
   * :oe:func:`OEChem::OETranslate` function
