visread 0.0.1.dev1

Use CASA6 to read visibilities from Measurement Sets

visread

A minimal tool built on CASA6 to read visibilities directly from calibrated CASA Measurement Sets

Introduction

The purpose of this package is to provide a quick and easy read("myFile.ms") function to load visibilities from a calibrated CASA Measurement Set file into memory in a Python program. You may wish to plot the baseline distributions, analyze the visibilities themselves, or synthesize images from them using software like MPoL.

The visibilities are returned as an object.

Code Example

import visread
vis = visread.read("myFile.ms")
print(vis)

More information is provided in the Documentation.

Currently, there is only one primary visibility container for spectral line measurement sets, whose attributes are driven by the development needs of the MPoL project. A set of single-channel continuum visibilities is just a subset of this.

If you identify and configure an additional visibility container (i.e., polarization), pull requests are welcome.

Installation

Because this package relies on CASA6, it is unfortunately subject to the stringent package requirements currently imposed by the modular CASA environment. As of January 2021, these are Python=3.6 and libgfortran3. This means that CASA6 and by extension this package will not work on Python 3.7, 3.8, or 3.9. More information on these requirements is here. Beyond this CASA dependency, the visread package itself is not tied to Python=3.6, so as the CASA requirements advance, so too will this package.

Lineage

The code in this package is fairly simple, but it is also built using CASA knowledge gained from a number of collaborators, who are credited in the CONTRIBUTORS.md file. You may also be interested in investigating the vis_sample and UVHDF5 packages, as they provide some similar capabilities with additional functionality.