CoaddProvenance#

class lsst.images.cells.CoaddProvenance(inputs: Table, contributions: Table)#

Bases: object

A pair of tables that record the inputs to a cell-based coadd.

Parameters#

inputs: A table of {visit, detector} combinations that contribute to any cell in the coadd.
contributions: A table of {visit, detector, cell} combinations that describe how an observation contributed to a cell.

Notes#

This object can represent the provenance of a whole patch, a single cell, or anything in between. In the single-cell case, the inputs and contributions tables have the same number of rows (but may not be ordered the same way!).

Attributes Summary

`contributions`	A table of {visit, detector, cell} combinations that describe how an observation contributed to a cell.
`inputs`	A table of {visit, detector} combinations that contribute to any cell in the coadd.

Methods Summary

`from_legacy`(legacy_cell_coadd)	Extract provenance from a legacy `lsst.cell_coadds.MultipleCellCoadd` object.
`make_empty_contribution_table`(n_rows)	Make an empty `contributions` table with a set number of rows.
`make_empty_input_table`(n_rows)	Make an empty `inputs` table with a set number of rows.
`serialize`(archive)	Serialize the provenance to an output archive.
`subset`(cells)	Return a new provenance object with just the given cells.
`to_legacy_cell_coadd_inputs`(observations)	Construct a mapping from legacy cell index to the list of legacy input structs for that cell.
`to_legacy_polygon_map`()	Construct a legacy mapping from `lsst.cell_coadds.ObservationIdentifiers` to `lsst.afw.geom.Polygon` from the `inputs` table.

Attributes Documentation

contributions#: A table of {visit, detector, cell} combinations that describe how an observation contributed to a cell.

inputs#: A table of {visit, detector} combinations that contribute to any cell in the coadd.

Methods Documentation

static from_legacy(legacy_cell_coadd: LegacyMultipleCellCoadd) → CoaddProvenance#

Extract provenance from a legacy lsst.cell_coadds.MultipleCellCoadd object.

Parameters#

legacy_cell_coadd: Legacy cell coadd to extract provenance from.

classmethod make_empty_contribution_table(n_rows: int) → Table#

Make an empty contributions table with a set number of rows.

Parameters#

n_rows: Number of rows in the new table.

classmethod make_empty_input_table(n_rows: int) → Table#

Make an empty inputs table with a set number of rows.

Parameters#

n_rows: Number of rows in the new table.

serialize(archive: OutputArchive[Any]) → CoaddProvenanceSerializationModel#

Serialize the provenance to an output archive.

Parameters#

archive: Archive to write to.

subset(cells: Iterable[CellIJ]) → CoaddProvenance#

Return a new provenance object with just the given cells.

Parameters#

cells: Cells to keep in the returned provenance.

to_legacy_cell_coadd_inputs(observations: Iterable[LegacyObservationIdentifiers] | None) → dict[LegacyIndex2D, dict[LegacyObservationIdentifiers, LegacyCellCoaddInputs]]#

Construct a mapping from legacy cell index to the list of legacy input structs for that cell.

Parameters#

observations: Observations to include, or None to include all observations in the inputs table.

to_legacy_polygon_map() → dict[LegacyObservationIdentifiers, LegacyPolygon]#: Construct a legacy mapping from lsst.cell_coadds.ObservationIdentifiers to lsst.afw.geom.Polygon from the inputs table.