:orphan:

.. _section_example_fastrocs_asisstarts:

AsIsStarts
===================

Return the results for a database for each query sorted by their rank in that
search. Attaches the shape Tanimoto as SD data.
Demonstrates the usage of the :ref:`OEShapeDatabase <OEFastROCS_OEShapeDatabase>`
with the AsIs molecule starting orientation.

.. note::

   The :ref:`OEShapeDatabase <OEFastROCS_OEShapeDatabase>` does not store molecular information, only
   coordinate information from each conformer. If the original molecule
   is required for output it is the responsibility of the programmer to
   maintain the relationship of the :ref:`OEShapeDatabase <OEFastROCS_OEShapeDatabase>` indices to
   the molecule. The reason for this design decision is to not force an
   additional memory overhead for an already memory intensive
   :ref:`OEShapeDatabase <OEFastROCS_OEShapeDatabase>` object.

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

.. oe:language:: c++

   .. code-block:: console

      prompt> asisstarts <database> [<queries> ... ]

   .. only:: oehtml

      .. admonition:: Download code

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

   .. only:: oepdf

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

.. oe:language:: python

   .. code-block:: console

      prompt> AsIsStartsExample.py <database> [<queries> ... ]
   
   .. only:: oehtml

      .. admonition:: Download code

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

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

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


   .. only:: oepdf

      .. oe:source:: AsIsStartsExample.py
         :language: python

.. oe:language:: java

   .. code-block:: console

      prompt> AsIsStartsExample <database> [<queries> ... ]
   
   .. only:: oehtml

      .. admonition:: Download code

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

   .. only:: oepdf

      .. oe:source:: AsIsStartsExample.java
         :language: java

.. seealso::

   * :oe:meth:`OEFastROCS::OEFastROCSOrientation::AsIs`
