healpix_geo.auto.elliptical_cone_coverage#

healpix_geo.auto.elliptical_cone_coverage(center, ellipse_geometry, position_angle, grid, *, delta_level=0, ellipsoid='sphere', flat=True)#

Search the cells covering the given elliptical cone.

Elliptical cone in this case refers to an ellipse on the surface of the reference ellipsoid.

Parameters:

  • center (numpy.ndarray or tuple of float) – The center of the box, either as a 2-sized array or as a 2-tuple of float.

  • ellipse_geometry (numpy.ndarray or tuple of float) – The semimajor and semimajor axis, as a 2-sized array or as a 2-tuple of float.

  • position_angle (float) – The orientation of the ellipse.

  • grid (Grid) – The definition of the HEALPix grid.

  • flat (bool, default: True) – If True, the cells returned will all be at the passed depth.

Returns:

  • cell_ids (numpy.ndarray) – The rasterized cell ids.

  • levels (numpy.ndarray) – The refinement levels of the cell ids. If flat is True, these will all have the same value. Only returned for nested and ring.

  • fully_covered (numpy.ndarray) – Boolean array marking whether the cells are fully covered by the ellipse.