:orphan:

.. _section_example_fastrocs_bestshapeoverlaymulticonfquery:

Best Shape Overlay Multiconformer Query
===========================================

This script gives an example of searching the database with every conformer
of every query.  The number of results depends on nHits and has a default
value of 100 per search. A cutoff can also be specified and the similarity
scoring function can be set to Tversky by adding the ``--tversky`` flag to
the command line (default = Tanimoto). Results are written to one file per
query molecule, with each conformer of the query molecule's results listed
sequentially.  The query conformer id is saved as an SD tag for ease of
identification.

.. warning::

   Running this script with large numbers of queries and high numbers of conformers will
      deplete system memory rapidly.

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

.. oe:language:: c++

   .. code-block:: console

      prompt> bestshapeoverlaymulticonfquery <database> <queries> [--nHits 100] [--cutoff N] [--tversky]
   
   .. only:: oehtml

      .. admonition:: Download code

         :download:`bestshapeoverlaymulticonfquery.cpp <../../../../../sublibs/tklibs/fastrocs/examples/bestshapeoverlaymulticonfquery.cpp>`

   .. only:: oepdf

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

.. oe:language:: python

   .. code-block:: console

      prompt> BestShapeOverlayMultiConfQuery.py <database> <queries> [--nHits 100] [--cutoff N] [--tversky]
   
   .. only:: oehtml

      .. admonition:: Download code

         :download:`BestShapeOverlayMultiConfQuery.py <../../../../../wrappers/python/examples/fastrocs/BestShapeOverlayMultiConfQuery.py>`

      .. :ref:`Full listing. <listing-BestShapeOverlayMultiConfQuery.py>`

      ..   literalinclude:: ../../../../../wrappers/python/examples/fastrocs/BestShapeOverlayMultiConfQuery.py



   .. only:: oepdf

      .. oe:source:: BestShapeOverlayMultiConfQuery.py
         :language: python

.. oe:language:: java

   .. code-block:: console

      prompt> BestShapeOverlayMultiConfQuery <database> <queries> [--nHits 100] [--cutoff N] [--tversky]
   
   .. only:: oehtml

      .. admonition:: Download code

         :download:`BestShapeOverlayMultiConfQuery.java <../../../../../wrappers/java/examples/openeye/examples/oefastrocs/BestShapeOverlayMultiConfQuery.java>`

   .. only:: oepdf

      .. oe:source:: BestShapeOverlayMultiConfQuery.java
         :language: java
