LineFileParser

Detailed Description

Parse identified and unidentified line files following the O3a convention.

The identified lines file contains detector spectral artifacts (lines and combs) verified to be non-astrophysical in origin. Each line of the file identifies an artifact with certain fundamental frequency, (possibly non-identical) frequency wings, the number of visible harmonics (if identified as a comb), the scaling of the affected band with harmonics (constant or linearly scaling), and a systematic off-set with respect to the specified frequency.

The unidentified lines file contains spectral artifacts that cannot yet be convincingly associated with non-astrophysical detector noise. These files only list the frequency of the most prominent peak.

This module provides a class, LineFileParser, to seamlessly read those files and return the list of lines as a list of [left_most_line_frequency, right_most_line_frequency] intervals. This format is easier to use for example when applying line vetoes on CW outliers.

Input files are fed into the class using LineFileParser.parse_identified_lines_csv or LineFileParser.parse_unidentified_lines_csv. Intervals are accesible through attributes LineFileParser.lines_left_side and LineFileParser.lines_right_side. If several files are read, their resulting intervals are concatenated (but not sorted, and duplicate or overlapping entries are kept as they are).

Data Structures
class	lalpulsar.lineFileParser.LineFileParser