:orphan:

.. _section_example_fastrocs_userinertialstarts:

User Inertial Starts
=====================

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
OEShapeDatabase with the UserInertialStarts molecule starting orientation.

.. note::

   The 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 OEShapeDatabase indices to
   the molecule. The reason for this design decision is to not force an
   additional memory overhead for an already memory intensive
   OEShapeDatabase object.

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

.. oe:language:: c++

   .. code-block:: console

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

   .. only:: oehtml

      .. admonition:: Download code

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

   .. only:: oepdf

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

.. oe:language:: python

   .. code-block:: console

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

      .. admonition:: Download code

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

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

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



   .. only:: oepdf

      .. oe:source:: UserInertialStartsExample.py
         :language: python

.. oe:language:: java

   .. code-block:: console

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

      .. admonition:: Download code

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

   .. only:: oepdf

      .. oe:source:: UserInertialStartsExample.java
         :language: java

.. seealso::

  * :oe:meth:`OEFastROCS::OEFastROCSOrientation::UserInertialStarts`
