healpix_geo.nested.cone_coverage#

healpix_geo.nested.cone_coverage(center, radius, depth, *, delta_depth=0, ellipsoid='sphere', flat=True)#

Search the cells covering the given cone

Cone in this case means a circle 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.

  • radius (float) – The radius of the cone, in degree.

  • depth (int) – The maximum depth of the cells to be returned.

  • ellipsoid (ellipsoid-like, default: "sphere") – Reference ellipsoid to evaluate healpix on. If the reference ellipsoid is spherical, this will return the same result as cdshealpix.nested.cone_search().

  • 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.

  • depths (numpy.ndarray) – The depths of the cell ids. If flat is True, these will all have the same value.

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