opticam.finders
===============

.. py:module:: opticam.finders


Classes
-------

.. autoapisummary::

   opticam.finders.DefaultFinder


Functions
---------

.. autoapisummary::

   opticam.finders.get_source_coords_from_image


Module Contents
---------------

.. py:class:: DefaultFinder(npixels, border_width = 0)

   Default source finder. Combines image segmentation with source deblending.


   .. py:attribute:: border_width
      :value: 0



   .. py:attribute:: finder


   .. py:method:: __call__(data, threshold)


.. py:function:: get_source_coords_from_image(image, finder, threshold, bkg = None, n_sources = None, background = None)

   Get an array of source coordinates from an image in descending order of source brightness.

   Parameters
   ----------
   image : NDArray
       The **non-background-subtracted** image from which to extract source coordinates.
   bkg : Background2D, optional
       The background of the image, by default None. If None, the background is estimated from the image.
   n_sources : int, optional
       The number of source coordinates to return, by default `None` (all sources will be returned).

   Returns
   -------
   NDArray
       The source coordinates in descending order of brightness.