read_table#

gwpy.io.ligolw.read_table(
source: Document | NamedReadable | list[NamedReadable],
tablename: str | None = None,
columns: Collection[str] | None = None,
contenthandler: type[ContentHandler] | None = None,
**kwargs,
) → Table[source]#

Read a Table from one or more LIGO_LW files.

Parameters:
sourceDocument, file, str, CacheEntry, list

object representing one or more files. One of

  • a LIGO_LW Document

  • an open file

  • a str pointing to a file path on disk

  • a formatted CacheEntry representing one file

  • a list of str file paths or CacheEntry

tablenamestr

name of the table to read.

columnslist, optional

list of column name strings to read, default all.

contenthandlerContentHandler, optional

SAX content handler for parsing LIGO_LW documents.

**kwargs

other keyword arguments are passed to read_ligolw

Returns:
tableTable

Table of data