gh-1034: Expose glass.healpix module (#1035)

Author: paddyroddy

.github/ISSUE_TEMPLATE/documentation.yaml

@@ -16,8 +16,6 @@ body:
     attributes:
       label: What Can be Improved About This Section
       description: Is it incomplete, incorrect or difficult to understand?
-    validations:
-      required: true
   - id: suggestions
     type: textarea
     attributes:

docs/modules/healpix.rst

@@ -0,0 +1,34 @@
+.. module:: glass.healpix
+
+:mod:`glass.healpix` --- Array API compatible HEALPix functions
+===============================================================
+
+.. currentmodule:: glass.healpix
+
+This module contains functions for working with HEALPix maps in an Array API
+compliant manner used with GLASS.
+
+This module should be imported manually if used outside of GLASS::
+
+    import glass.healpix as hp
+
+``healpix`` Functions
+---------------------
+
+.. autofunction:: ang2pix
+.. autofunction:: ang2vec
+.. autofunction:: npix2nside
+.. autofunction:: nside2npix
+.. autofunction:: randang
+
+``healpy`` Functions
+--------------------
+
+.. autofunction:: alm2map
+.. autofunction:: alm2map_spin
+.. autofunction:: almxfl
+.. autofunction:: get_nside
+.. autofunction:: map2alm
+.. autofunction:: pixwin
+.. autofunction:: query_strip
+.. automethod:: Rotator.rotate_map_pixel

docs/modules/index.rst

@@ -9,3 +9,4 @@ Modules
    arraytools
    grf
    harmonics
+   healpix

glass/__init__.py

@@ -41,6 +41,7 @@
     "glass_to_healpix_spectra",
     "grf",
     "harmonics",
+    "healpix",
     "healpix_to_glass_spectra",
     "iternorm",
     "linear_bias",
@@ -79,7 +80,7 @@
     from ._version import __version__
 
 # modules
-from glass import algorithm, arraytools, grf, harmonics
+from glass import algorithm, arraytools, grf, harmonics, healpix
 from glass.fields import (
     check_posdef_spectra,
     cls2cov,