Skip to main content

cubevis is a visualization toolkit for radio astronomy image and visibility data, built on Bokeh for the front-end and CASA for the processing backend. Python and CASA drive image/data access while a generated JavaScript interface provides an interactive control front-end, usable from JupyterLab, Google Colab, or plain Python scripts.

cubevis currently provides two applications:

  • Interactive Clean (iclean) - released. Visually observe and control CASA’s image reconstruction (tclean/deconvolve). See Interactive Clean below.

  • Visibility Plotter (visplot) - in development. Interactive visibility-domain plotting supporting both legacy CASA Measurement Sets (MSv2) and the newer AstroVIPER Measurement Set v4 format, via xarray-ms. visplot has no stable end-user API yet; it is not ready for general use.

This is a beta-release quality package.

Installation

cubevis uses optional extras so that installing it doesn’t pull in more than a given application needs. The extras you want depend on which application you’re using:

# Interactive Clean (released)
pip install cubevis[iclean]

# Visibility Plotter (in development - no stable API yet)
pip install cubevis[visplot]

# add Jupyter/anywidget support for either, if working in a notebook
pip install cubevis[iclean,notebook]

iclean depends on CASA6’s casatasks. visplot depends on xarray-ms / arcae for both its MSv2 and MSv4 backends, so it does not require casatasks even when working with legacy Measurement Sets.

iclean and visplot are convenience aliases for the underlying casa6 and xarray extras, respectively; those backend-named extras are also available directly for anyone assembling a custom environment. Installing casa6 and xarray together in the same plain pip environment is not currently supported, since the two backends can require mutually incompatible native library versions (notably libprotobuf) that pip has no mechanism to reconcile - use a pixi or conda environment for combined installs.

Interactive Clean

Interactive clean is the primary application provided by this package. It allows for visualizally observing and controlling the image reconstruction performed by CASA. The primary CASA tasks used to perform the image reconstruction are tclean and deconvolve.

Usage

This example provide a summary of how to use interactive clean from Python:

from cubevis import iclean

iclean( vis='refim_twopoints_twochan.ms', imagename='test',
        imsize=100, cell='8.0arcsec',
        phasecenter="J2000 19:59:28.500 +40.44.01.50",
        outlierfile='test_outlier.txt',
        niter=50, cycleniter=10, deconvolver='hogbom',
        specmode='mfs', spw='0:0' )

For this sample, the test measurement set is available, while the outlierfile would look something like:

imagename=try_multifield_1
imsize=[80,80]
cell=[8.0arcsec,8.0arcsec]
phasecenter=J2000 19:58:41.095 +40.56.01.043

Visibility Plotter

visplot is under active development and does not yet have a stable end-user API - it isn’t ready for general use, and this README will be updated with usage instructions once one is available.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cubevis-1.0.77.tar.gz (9.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cubevis-1.0.77-py3-none-any.whl (1.3 MB view details)

Uploaded Python 3

File details

Details for the file cubevis-1.0.77.tar.gz.

File metadata

  • Download URL: cubevis-1.0.77.tar.gz
  • Upload date:
  • Size: 9.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for cubevis-1.0.77.tar.gz
Algorithm Hash digest
SHA256 e3d981afe4894b2a032e27294d3d6a0d5f23f9f959e448663eb820c098ca13b1
MD5 4afdb82b125d1f2a69ea7db8bac2e2b0
BLAKE2b-256 da1423586d910f159f3ec262e3a9e20300c8b4884a7c7cb7bc8a5912693e4b2e

See more details on using hashes here.

Provenance

The following attestation bundles were made for cubevis-1.0.77.tar.gz:

Publisher: publish.yml on casangi/cubevis

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cubevis-1.0.77-py3-none-any.whl.

File metadata

  • Download URL: cubevis-1.0.77-py3-none-any.whl
  • Upload date:
  • Size: 1.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for cubevis-1.0.77-py3-none-any.whl
Algorithm Hash digest
SHA256 3c060f5279c8fb10a3c33be2e08d79cf3812857cc3d2c31a7be1e1ef96cb9b43
MD5 a8e069fd879eee8b966e4212a7432376
BLAKE2b-256 ee8e5a2bfbcc4f3e3a3d5fca9df6784fd31ad531b3af869194169da3cf8381af

See more details on using hashes here.

Provenance

The following attestation bundles were made for cubevis-1.0.77-py3-none-any.whl:

Publisher: publish.yml on casangi/cubevis

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.0.78

2 files

This release

1.0.77 This release

2 files

1.0.76

2 files

1.0.75

2 files

1.0.74

2 files

1.0.73

2 files

1.0.72

2 files

1.0.71

2 files

1.0.70

2 files

1.0.69

2 files

1.0.68

2 files

1.0.66

2 files

1.0.65

2 files

1.0.64

2 files

1.0.63

2 files

1.0.62

2 files

1.0.61

2 files

1.0.60

2 files

1.0.59

2 files

1.0.58

2 files

1.0.57

2 files

1.0.56

2 files

1.0.55

2 files

1.0.54

2 files

1.0.53

2 files

1.0.52

2 files

1.0.51

2 files

1.0.50

2 files

1.0.49

2 files

1.0.48

2 files

1.0.47

2 files

1.0.46

2 files

1.0.45

2 files

1.0.44

2 files

1.0.43

2 files

1.0.42

2 files

1.0.41

2 files

1.0.40

2 files

1.0.39

2 files

1.0.38

2 files

1.0.37

2 files

1.0.36

2 files

1.0.35

2 files

1.0.34

2 files

1.0.33

2 files

1.0.32

2 files

1.0.31

2 files

1.0.30

2 files

1.0.29

2 files

1.0.28

2 files

1.0.27

2 files

1.0.26

2 files

1.0.25

2 files

1.0.24

2 files

1.0.23

2 files

1.0.22

2 files

1.0.21

2 files

1.0.20

2 files

1.0.19

2 files

1.0.18

2 files

1.0.17

2 files

1.0.16

2 files

1.0.15

2 files

1.0.14

2 files

1.0.11

2 files

1.0.10

2 files

1.0.9

2 files

1.0.8

2 files

1.0.7

2 files

1.0.6

2 files

1.0.5

2 files

1.0.4

2 files

1.0.3

2 files

1.0.0

2 files

0.5.29

2 files

0.5.28

2 files

0.5.27

2 files

0.5.26

2 files

0.5.25

2 files

0.5.24

2 files

0.5.23

2 files

0.5.22

2 files

0.5.21

2 files

0.5.20

2 files

0.5.19

2 files

0.5.18

2 files

0.5.17

2 files

0.5.16

2 files

0.5.15

2 files

0.5.14

2 files

0.5.13

2 files

0.5.12

2 files

0.5.11

2 files

0.5.10

2 files

0.5.7

2 files

0.5.2

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page