.. include:: ../substitutions

.. oe:namespace:: OEDepict

.. meta::
   :keywords: OEGetNearbyAtom

.. _OEDepict_OEGetNearbyAtom:


.. oe:function:: OEGetNearbyAtom


   .. oe:language:: c++ java csharp

      .. oe:api::

         OENearestAtom OEGetNearbyAtom(const OE2DMolDisplay& disp,
                                       const OE2DPoint& point,
                                       double radiusscale = 1.0)

   .. oe:language:: python

      .. oe:api:: python

         OEGetNearbyAtom(disp: OE2DMolDisplay, p: OE2DPoint,
                         radiusscale: float = 1.0) -> OENearestAtom

   Returns an :ref:`OENearestAtom <OEDepict_OENearestAtom>` object that stores a pointer
   of the atom which is depicted nearest to a given 2D display coordinates.
   By default, only atoms that are no further than half bond away from the given
   point will be considered.

   *disp*
      The :ref:`OE2DMolDisplay <OEDepict_OE2DMolDisplay>` object of which atoms are being
      considered.
      Only atoms of which atom display is visible are examined
      (:oe:meth:`OEDepict::OEAtomDisplayBase::IsVisible`)

   *point*
      Specifies the 2D display coordinates.

   *radiusscale*
       The multiplier that can be used to increase or to decrease the
       radius around the given point to be considered.
       This value has to be in a range of :math:`[0.25, 2.0]`.

   .. note::

      If there is no atom close to the given display coordinates,
      then the :oe:meth:`OEDepict::OENearestAtom::IsValid` method returns
      `false`.

   .. seealso::

      * :ref:`OENearestAtom <OEDepict_OENearestAtom>` class
      * :oe:func:`OEDepict::OEGetNearestAtom` function
      * :oe:func:`OEDepict::OEGetNearbyBond` function
