AOQUALITY(1)

Okay bestie, welcome to the AOQUALITY(1) manual, filed under General Commands Manual, which is giving very formal energy πŸŽ€

✨ NAME ✨

AOQuality is the tool for handling AOFlagger measurement set quality statistics πŸ’–

πŸ“‹ SYNOPSIS πŸ“‹

Here's how you call it, no cap 🫢

aoquality <action> [options]

🎬 ACTIONS 🎬

Okay so every single thing you do with this tool is an action. Let's go through them all, iykyk πŸ’…

help

  • help β€” Need more info on an action? Run aoquality help <action> and it'll spill the tea πŸ“

collect

collect [-c/-tf/-h] <ms> [quack timesteps] [list of antennae]

This one is lowkey the main event πŸ”₯ collect goes through your whole measurement set and gathers the default statistics. Then it writes the results into the quality subtables of the main measurement set. Iconic.

The default stats are RFIRatio, Count, Mean, SumP2, DCount, DMean and DSumP2 ✨

The subtables that get updated are QUALITY_KIND_NAME, QUALITY_TIME_STATISTIC, QUALITY_FREQUENCY_STATISTIC and QUALITY_BASELINE_STATISTIC. They're all getting glow-ups 🌸

  • -c β€” Uses the CORRECTED_DATA column and writes the results into the quality tables.
  • -tf and -h β€” These show up in the synopsis, but the page doesn't explain what they do, so I'm not gonna guess and lead you astray πŸ™ˆ

combine

combine <target_ms> [<in_ms> [<in_ms> ..]

Main character energy πŸ‘‘ combine reads all the input measurement sets you give it, combines their statistics, and writes everything into one target measurement set. The target should not exist beforehand, so don't pre-make it, bestie πŸ¦‹

histogram

histogram <query> <ms>

Various histogram actions live here πŸ“Š The <query> can be:

  • rfislope β€” Does a linear regression on the part of the histogram that's supposed to hold the RFI. It reports one value per polarisation 🌈

liststats

  • liststats β€” Shows you a list of all the possible statistic kinds. Very helpful, very on brand πŸ’œ

query_b

query_b <kind> <ms>
  • query_b β€” Prints the given statistic for each baseline 🧚

query_t

query_t <kind> <ms>
  • query_t β€” Prints the given statistic for each time step ⏰

query_f

query_f <kind> <ms>
  • query_f β€” Prints the given statistic for each frequency 🌈

query_g

query_g <kind> <ms>
  • query_g β€” Prints the given statistic for this whole measurement set. One big vibe ✨

remove

remove [ms]
  • remove β€” Completely removes all quality tables from the measurement set.
Bestie, this one is a full wipe. "Completely" is doing a lot of work here πŸ’€

summarize

summarize <ms>
  • summarize β€” Gives you a summary of the statistics in the measurement set πŸ“

summarizerfi

  • summarizerfi β€” Gives you a summary of the RFI statistics. Lowkey underrated πŸ”₯

πŸ’… Statistic kinds πŸ’…

A few actions need a statistic kind. Some of the common ones are StandardDeviation, Variance, Mean, RFIPercentage, RFIRatio and Count. These are case sensitive, so spell them exactly like that, periodt 😭 Run aoquality liststats to see the full list.

That's the whole tea, bestie. AOQUALITY, September 2016, AOQUALITY(1). Go be a quality queen πŸ‘‘πŸ’–