ReadTextCatalogTask¶

ReadTextCatalogTask reads an object catalog from a UTF-8 encoded text file into a numpy array object suitable for use with lsst.meas.algorithms.IngestIndexReferenceTask.

Python API summary¶

from lsst.meas.algorithms.readTextCatalogTask import ReadTextCatalogTask

classReadTextCatalogTask(config: Optional[Config] = None, name: Optional[str] = None, parentTask: Optional[Task] = None, log: Optional[Union[logging.Logger, lsst.utils.logging.LsstLogAdapter]] = None): Read an object catalog from a text file...

attributeconfig: Access configuration fields and retargetable subtasks.

methodrun(filename): Read an object catalog from the specified text file...

Retargetable subtasks¶

No subtasks.

Configuration fields¶

colnames¶

Default: []
Field type: str ListField

An ordered list of column names to use in ingesting the catalog. With an empty list, column names will be discovered from the first line after the skipped header lines.

delimiter¶

Default: ','
Field type: str Field

Delimiter to use when reading text reference files. Comma is default.

format¶

Default: 'csv'
Field type: str Field

Format of files to read, from the astropy.table I/O list here:http://docs.astropy.org/en/stable/io/unified.html#built-in-table-readers-writers

header_lines¶

Default: 0
Field type: int Field

Number of lines to skip when reading the text reference file.

Examples¶

Given a file named table.csv containing the following:: ra, dec, flux 5.5, -45.2, 12453 19.6, 34.2, 32123

you can read this file with the following code:

from lsst.meas.algorithms.readTextCatalogTask import ReadTextCatalogTask
task = ReadTextCatalogTask()
catalogArray = task.run("table.csv")

The resulting catalogArray is a numpy structured array containing three fields (“ra”, “dec” and “flux”) and two rows of data. For more complex cases, config parameters allow you to specify the names of the columns (instead of using automatic discovery) and set the number of rows to skip.

Navigation