msutils

Everyday Measurement Set operations.

msutils is a library and CLI for the routine things you do to a Measurement Set: look inside it, take a piece of it, average it, add and drop columns, and keep track of flags. It does not calibrate or image — those belong in the tools built for them.

The entry point is msinfo(), which returns a typed, addressable description of an MS:

import msutils

info = msutils.msinfo("obs.ms")
print(info.render())

info.fields["PKS1934-638"].scan_numbers   # [1, 2]
info.spws[0].chan_width[0]                # 10000000.0
info.antennas["m003"].latitude            # -30.71053

$ msutils info obs.ms
$ msutils subset obs.ms target.ms --field DEEP_2
$ msutils flagstats obs.ms --plot flags.png

The same call reads MSv2 tables and MSv4 processing sets, returning the same MSInfo either way — see MSv2, MSv4, and reader engines.

Getting started

• Installation
  • Optional extras
  • From source
• Quickstart
  • Look inside an MS
  • Take a piece of it
  • Columns
  • Flags
  • Diagnostics

Concepts

• MSv2, MSv4, and reader engines
  • Engines
  • Why casacore stays the MSv2 default
  • Converting
• Reading big Measurement Sets
  • Aggregate in TaQL, not in Python
  • Levels: read only what you need
  • Geometry beats data

Reference

• API reference
  • Top-level package
  • Metadata
  • Column operations
  • Subsetting and averaging
  • Flags
  • Diagnostics
  • Format conversion
  • Deprecated

Project

• Contributing
• Code of Conduct
• Changelog

Indices

• Index

• Module Index