Metadata-Version: 2.3
Name: aoquality
Version: 0.3.0
Summary: Python module to access Measurement Sets' quality statistics produced by aoflagger, aoquality or DPPP.
License: GPL-3.0-or-later
Author: "Florent Mertens"
Author-email: "florent.mertens@gmail.com"
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: click (>=7.0,<9.0)
Requires-Dist: importlib-metadata (>=1.0,<2.0) ; python_version < "3.8"
Requires-Dist: matplotlib (>=3.0,<4.0)
Requires-Dist: python-casacore (>=3.0,<4.0)
Project-URL: Repository, https://gitlab.com/flomertens/aoquality/
Description-Content-Type: text/markdown

# aoquality

`aoquality` reads and analyses the Measurement Set **quality statistics**
produced by [AOFlagger](https://aoflagger.readthedocs.io), `aoquality`, or
[DP3](https://dp3.readthedocs.io).

It provides a small Python API over the three AOQuality table types (baseline,
frequency, and time statistics) — reading a single Measurement Set or combining
many — and a command-line tool, `aostats`, for diagnostic plots and outlier
detection across many observations.

**Documentation: https://pyaoquality.readthedocs.io**

## Installation

```bash
pip install aoquality
```

Requires Python ≥ 3.8.

## Quick start

Python API:

```python
import aoquality

bl = aoquality.BaselineStat('obs.MS')
ant_names, ant_stats = bl.get_antenna_stat('SNR')   # (n_ant,), (n_ant, n_pol)
```

Command line:

```bash
aostats plot obs.MS SNR -o stat_snr            # single-MS diagnostic plots
aostats plot-grid obs1/ obs2/ obs3/ SNR        # multi-observation grids
aostats find-bad-stations *.qs SNR -o bad.json # flag outlier antennas
```

See the [documentation](https://pyaoquality.readthedocs.io) for the full Python
API, usage guide, and `aostats` command-line reference.

