lsst.dax.apdb.pixelization.Pixelization Class Reference

Public Member Functions
	__init__ (self, str pixelization, int pix_level, int pix_max_ranges)
list[int]	pixels (self, sphgeom.Region region)
int	pixel (self, sphgeom.UnitVector3d direction)
list[tuple[int, int]]	envelope (self, sphgeom.Region region)

Public Attributes
	pixelator

Protected Attributes
	_pix_max_ranges

Detailed Description

Wrapper for pixelization classes from `sphgeom` with configurable
pixelization type and parameters.

Parameters
----------
pixelization : `str`
    Name of a pixelization type, one of ""htm", "q3c", or "mq3c"
pix_level : `int`
    Pixelization level.
pix_max_ranges : `int`
    Maximum number of ranges returned from `envelope()` method.

Definition at line 33 of file pixelization.py.

Constructor & Destructor Documentation

__init__()

lsst.dax.apdb.pixelization.Pixelization.__init__	(		self,
		str	pixelization,
		int	pix_level,
		int	pix_max_ranges )

Definition at line 47 of file pixelization.py.

    def __init__(self, pixelization: str, pix_level: int, pix_max_ranges: int):
        if pixelization == "htm":
            self.pixelator = sphgeom.HtmPixelization(pix_level)
        elif pixelization == "q3c":
            self.pixelator = sphgeom.Q3cPixelization(pix_level)
        elif pixelization == "mq3c":
            self.pixelator = sphgeom.Mq3cPixelization(pix_level)
        else:
            raise ValueError(f"unknown pixelization: {pixelization}")
        self._pix_max_ranges = pix_max_ranges
 

Member Function Documentation

envelope()

list[tuple[int, int]] lsst.dax.apdb.pixelization.Pixelization.envelope	(		self,
		sphgeom.Region	region )

Generate a set of HTM indices covering specified region.

Parameters
----------
region: `sphgeom.Region`
    Region that needs to be indexed.

Returns
-------
ranges : `list` of `tuple`
    Sequence of ranges, range is a tuple (minHtmID, maxHtmID).

Definition at line 82 of file pixelization.py.

    def envelope(self, region: sphgeom.Region) -> list[tuple[int, int]]:
        """Generate a set of HTM indices covering specified region.
 
        Parameters
        ----------
        region: `sphgeom.Region`
            Region that needs to be indexed.
 
        Returns
        -------
        ranges : `list` of `tuple`
            Sequence of ranges, range is a tuple (minHtmID, maxHtmID).
        """
        _LOG.debug("region: %s", region)
        indices = self.pixelator.envelope(region, self._pix_max_ranges)
 
        if _LOG.isEnabledFor(logging.DEBUG):
            for irange in indices.ranges():
                _LOG.debug(
                    "range: %s %s",
                    self.pixelator.toString(irange[0]),
                    self.pixelator.toString(irange[1]),
                )
 
        return indices.ranges()

pixel()

int lsst.dax.apdb.pixelization.Pixelization.pixel	(		self,
		sphgeom.UnitVector3d	direction )

Compute the index of the pixel for given direction.

Parameters
----------
direction : `lsst.sphgeom.UnitVector3d`

Definition at line 72 of file pixelization.py.

    def pixel(self, direction: sphgeom.UnitVector3d) -> int:
        """Compute the index of the pixel for given direction.
 
        Parameters
        ----------
        direction : `lsst.sphgeom.UnitVector3d`
        """
        index = self.pixelator.index(direction)
        return index
 

pixels()

list[int] lsst.dax.apdb.pixelization.Pixelization.pixels	(		self,
		sphgeom.Region	region )

Compute set of the pixel indices for given region.

Parameters
----------
region : `lsst.sphgeom.Region`

Definition at line 58 of file pixelization.py.

    def pixels(self, region: sphgeom.Region) -> list[int]:
        """Compute set of the pixel indices for given region.
 
        Parameters
        ----------
        region : `lsst.sphgeom.Region`
        """
        # we want finest set of pixels, so ask as many pixel as possible
        ranges = self.pixelator.envelope(region, 1_000_000)
        indices = []
        for lower, upper in ranges:
            indices += list(range(lower, upper))
        return indices
 

Member Data Documentation

_pix_max_ranges

lsst.dax.apdb.pixelization.Pixelization._pix_max_ranges

protected

Definition at line 56 of file pixelization.py.

pixelator

lsst.dax.apdb.pixelization.Pixelization.pixelator

Definition at line 49 of file pixelization.py.

---

The documentation for this class was generated from the following file:

• /j/snowflake/release/lsstsw/stack/lsst-scipipe-8.0.0/Linux64/dax_apdb/g295015adf3+81dd352a9d/python/lsst/dax/apdb/pixelization.py