Metadata-Version: 2.4
Name: hats
Version: 0.7.0
Summary: Hierarchical Adaptive Tiling Scheme Catalog
Author-email: LINCC Frameworks <lincc-frameworks-team@lists.lsst.org>
License-Expression: BSD-3-Clause
Project-URL: Source Code, https://github.com/astronomy-commons/hats
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: astropy>=6.1.5
Requires-Dist: cdshealpix>=0.7.0
Requires-Dist: fsspec>=2023.10.0
Requires-Dist: jproperties>=2.0.0
Requires-Dist: matplotlib>=3.10.1
Requires-Dist: mocpy>=0.17.1
Requires-Dist: nested-pandas>=0.4.1
Requires-Dist: numba>=0.58
Requires-Dist: numpy<3,>=2
Requires-Dist: pandas>=2.0
Requires-Dist: pyarrow!=19.0.0,!=21.0.0,>=14.0.1
Requires-Dist: pydantic>=2.0
Requires-Dist: scipy>=1.7.2
Requires-Dist: typing-extensions>=4.3.0
Requires-Dist: universal-pathlib<0.3.0,>=0.2.2
Provides-Extra: dev
Requires-Dist: asv[virtualenv]==0.6.5; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: jupyter; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: pylint; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: pytest-mock; extra == "dev"
Requires-Dist: pytest-timeout; extra == "dev"
Provides-Extra: full
Requires-Dist: fsspec[full]; extra == "full"
Requires-Dist: lsst-sphgeom; (sys_platform == "darwin" or sys_platform == "linux") and extra == "full"
Dynamic: license-file

<img src="https://github.com/astronomy-commons/lsdb/blob/main/docs/lincc-logo.png?raw=true" width="300" height="100">

# HATS

[![Template](https://img.shields.io/badge/Template-LINCC%20Frameworks%20Python%20Project%20Template-brightgreen)](https://lincc-ppt.readthedocs.io/en/stable/)

[![PyPI](https://img.shields.io/pypi/v/hats?color=blue&logo=pypi&logoColor=white)](https://pypi.org/project/hats/)
[![Conda](https://img.shields.io/conda/vn/conda-forge/hats.svg?color=blue&logo=condaforge&logoColor=white)](https://anaconda.org/conda-forge/hats)

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/astronomy-commons/hats/smoke-test.yml)](https://github.com/astronomy-commons/hats/actions/workflows/smoke-test.yml)
[![codecov](https://codecov.io/gh/astronomy-commons/hats/branch/main/graph/badge.svg)](https://codecov.io/gh/astronomy-commons/hats)
[![Read the Docs](https://img.shields.io/readthedocs/hats)](https://hats.readthedocs.io/)
[![benchmarks](https://img.shields.io/github/actions/workflow/status/astronomy-commons/hats/asv-main.yml?label=benchmarks)](https://astronomy-commons.github.io/hats/)

## Hierarchical Adaptive Tiling Scheme

A HATS catalog is a partitioning of objects on a sphere. Its purpose is for 
storing data from large astronomy surveys, but could probably be used for other 
use cases where you have large data with some spherical properties.

Check out our [ReadTheDocs site](https://hats.readthedocs.io/en/stable/)
for more information on partitioning, installation, and contributing.

See related projects:

* HATS Import ([on GitHub](https://github.com/astronomy-commons/hats-import))
  ([on ReadTheDocs](https://hats-import.readthedocs.io/en/stable/))
* LSDB ([on GitHub](https://github.com/astronomy-commons/lsdb)) 
  ([on ReadTheDocs](https://lsdb.readthedocs.io/en/stable/))

## Contributing

[![GitHub issue custom search in repo](https://img.shields.io/github/issues-search/astronomy-commons/hats?color=purple&label=Good%20first%20issues&query=is%3Aopen%20label%3A%22good%20first%20issue%22)](https://github.com/astronomy-commons/hats/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)

See the [contribution guide](https://hats.readthedocs.io/en/stable/guide/contributing.html)
for completed installation instructions and contribution best practices.

## Citation

If you use HATS in your work, please cite the conference proceedings: 
["Using LSDB to enable large-scale catalog distribution, cross-matching, and analytics"](https://ui.adsabs.harvard.edu/abs/2025arXiv250102103C). 

If you use Rubin Data Preview 1 (DP1) with HATS, please also cite: ["Variability-finding in Rubin Data Preview 1 with LSDB"](https://ui.adsabs.harvard.edu/abs/2025arXiv250623955M).

Find full citation information [here](./CITATION.bib).

## Acknowledgements

This project is supported by Schmidt Sciences.

This project is based upon work supported by the National Science Foundation under Grant No. AST-2003196.

This project acknowledges support from the DIRAC Institute in the Department of Astronomy at the University of Washington. The DIRAC Institute is supported through generous gifts from the Charles and Lisa Simonyi Fund for Arts and Sciences, and the Washington Research Foundation.
