.. _user_guide:

**********
User Guide
**********

Photutils is a Python library that provides commonly-used tools and key
functionality for detecting and performing photometry of astronomical
sources. Photutils is organized into subpackages covering different
topics, which are listed below.


Backgrounds
-----------

.. toctree::
    :maxdepth: 1

    background.rst

Centroids
---------
.. toctree::
    :maxdepth: 1

    centroids.rst

Source Detection
----------------

.. toctree::
    :maxdepth: 1

    detection.rst
    General Source Detection and Extraction (photutils.segmentation) <segmentation.rst>

Segmentation and Source Measurements
------------------------------------

.. toctree::
    :maxdepth: 1

    segmentation.rst
    morphology.rst

Aperture Photometry
-------------------

.. toctree::
    :maxdepth: 1

    aperture.rst

PSF Photometry
--------------

.. toctree::
    :maxdepth: 1

    psf.rst
    epsf_building.rst
    grouping.rst

PSF Matching
------------

.. toctree::
    :maxdepth: 1

    psf_matching.rst

Profiles
--------
.. toctree::
    :maxdepth: 1

    radial_profiles.rst
    curves_of_growth.rst

Elliptical Isophotes
--------------------
.. toctree::
    :maxdepth: 1

    isophote.rst


Datasets and Simulation
-----------------------
.. toctree::
    :maxdepth: 1

    datasets.rst


Utilities
---------

.. toctree::
    :maxdepth: 1

    utils.rst
    geometry.rst
