xradio 1.0.0

Xarray Radio Astronomy Data IO

xradio

Xarray Radio Astronomy Data IO is still in development.

Installing

XRADIO can be installed in virtual environments via pip. It is recommended to use the conda environment manager from miniforge to create a clean, self-contained runtime where XRADIO and all its dependencies can be installed, for example:

conda create --name xradio python=3.13 --no-default-packages
conda activate xradio

📝 On macOS, if one wants to use the functions to convert MSv2=>MSv4, it is required to pre-install python-casacore. That can be done using conda install -c conda-forge python-casacore. See more alternatives below.

XRADIO can now be installed using:

pip install xradio

This will also install the minimal dependencies for XRADIO.

Note that if only the minimal dependencies are installed, the functionality to convert MSv2 to MSv4 will not be available. This requires installing python-casacore (also included in the all group, see below), or alternatively the casatools backend, as explained in the casatools I/O backend guide.

To install the minimal dependencies and the interactive components (JupyterLab) use:

pip install "xradio[interactive]"

To enable conversion from MSv2 to MSv4 use (this only works for Linux):

pip install "xradio[python-casacore]"

To be able to run tests:

pip install "xradio[test]"

Multiple-dependencies can be installed using:

pip install "xradio[interactive,python-casacore,test]"

To install a more complete set of dependencies:

pip install "xradio[all]"

This will include the dependencies required to run the interactive Jupyter notebooks, run tests, build documentation, and python-casacore to enable MSv2=>MSv4 functionality.