pqcΒΆ

Provide PTA residual quality-control utilities.

PQC implements a lightweight workflow for quality control (QC) of pulsar timing array (PTA) residuals. The package is intentionally small and focuses on a single end-to-end pipeline that loads timing data, merges metadata, and annotates TOAs with QC flags and diagnostics.

Key capabilities include:

  • Parsing tempo2 timfiles (including INCLUDE recursion and flags).

  • Loading TOA/residual arrays via libstempo.

  • Merging timing arrays with timfile metadata.

  • Normalizing backend keys (sys/group) for per-backend analysis.

  • Detecting bad measurements, transients, step/DM-step events.

  • Detecting global astrophysical events (exp-dips, solar, eclipses, gaussian-bumps, glitches).

  • Optional feature extraction and feature-domain structure diagnostics.

Most users should start with pqc.pipeline.run_pipeline() or the CLI entry point in pqc.cli.

See also

pqc.pipeline.run_pipeline: End-to-end QC pipeline for a single pulsar. pqc.cli.main: CLI entry point for batch or scripted runs.

Modules

cli

Provide a command-line interface for the PQC pipeline.

config

Define configuration objects for the PQC pipeline.

detect

Provide detection algorithms for PTA QC.

features

Provide feature engineering utilities for PTA QC.

io

Provide IO helpers for PTA QC.

pipeline

Run the end-to-end PQC pipeline.

preproc

Preprocessing utilities for covariate-conditioned detection.

utils

Provide utility helpers for PTA QC.