ingest_injection_catalog

lsst.source.injection.ingest_injection_catalog(writeable_butler: Butler, table: Table | list[astropy.table.table.Table], band: str, output_collection: str, dataset_type_name: str = 'injection_catalog', log_level: int = 20) → list[lsst.daf.butler._dataset_ref.DatasetRef]

Ingest a source table into the butler.

This function ingests either a single astropy Table or list of Tables into the Butler. If a list of Tables is provided, these will be vertically stacked together into one single Table for ingestion. Input source tables are expected to contain the columns ra and dec, with data in units of degrees. This spatial information will be used to shard up the source table on-disk using a depth 7 Hierarchical Triangular Mesh (HTM7) format. HTM7 trixels have an area of ~0.315 square degrees.

Parameters:

writeable_butlerlsst.daf.butler.Butler

An instantiated writeable butler.

tableastropy.table.Table or list [astropy.table.Table]

Input source table(s). Requires columns ra and dec in degrees.

bandstr

Band associated with the input source table(s).

output_collectionstr

Name of the output collection to ingest the consolidated table into.

dataset_type_namestr, optional

Dataset type name for the ingested consolidated table.

log_levelint, optional

The log level to use for logging.

Returns:

dataset_refslist [lsst.daf.butler.DatasetRef]

List containing the dataset refs for the ingested source table.