Getting Started with HATS
=========================

Installation
------------

The latest release version of HATS is available to install with 
`pip <https://pypi.org/project/hats/>`__ or 
`conda <https://anaconda.org/conda-forge/hats>`__:

.. code-block:: bash

    python -m pip install hats

.. code-block:: bash

    conda install -c conda-forge hats

.. hint::

    We recommend using a virtual environment. Before installing the package, create and activate a fresh
    environment. Here are some examples with different tools:

    .. tab-set::

        .. tab-item:: venv

            .. code-block:: bash

                python -m venv ./hats_env
                source ./hats_env/bin/activate

        .. tab-item:: pyenv

            With the pyenv-virtualenv plug-in:

            .. code-block:: bash

                pyenv virtualenv 3.11 hats_env
                pyenv local hats_env

    We recommend Python versions **>=3.10, <=3.13**.

HATS can also be installed from source on `GitHub <https://github.com/astronomy-commons/hats>`__.

LSDB
----

For the most part, we recommend accessing and processing HATS data using the 
`LSDB framework package <https://github.com/astronomy-commons/lsdb>`__.
LSDB provides a variety of utility functions as well as a lazy, 
distributed execution framework using Dask.

For details on LSDB, see the `readthedocs site <https://docs.lsdb.io/en/stable/>`__.