Coming from plotms

This page goes through CASA plotms’s parameters in the order the CASA documentation lists them, and gives the visplot equivalent of each: the Python argument, the value, or the setting in the window.

Review status

This table was compiled on 2026-11-16 from the CASA plotms documentation and the visplot source, and no row has been reviewed yet. When a tester confirms a row, the Reviewed column gets their initials and the date. Corrections are welcome, especially for rows marked Different.

Status means:

  • Same: works the same way.

  • Different: available, but works differently; the note says how.

  • Partial: some of it is available.

  • Not yet: not available.

  • N/A: does not apply to how visplot draws.

visplot’s arguments are those of the visplot(...) task call; see Starting visplot.

Data and selection

plotms

visplot

Status

Notes

See

Reviewed

vis

vis

Same

MSv2 or MSv4; the format is detected

Data

caltable

Not yet

Calibration tables cannot be plotted

Data

xdatacolumn, ydatacolumn: data, corrected, model

datacolumn

Different

One column for the whole plot, not one per axis

Data

xdatacolumn, ydatacolumn: float, residuals (corrected-model …), ratios

Not yet

Data

field

field

Same

Selection

spw

spw

Partial

Spectral windows by index; no spw:chan channel ranges

Selection

timerange

timerange

Same

One range

Selection

uvrange

uvrange

Same

Selection

antenna

antenna

Partial

Names, IDs, ! exclusion and NAME&NAME baselines

Selection

scan

scan

Same

Selection

correlation

correlation

Same

Stokes conversion is not offered

Selection

array, observation, intent, feed, msselect

Not yet

autocorrelations, selected through antenna

autocorr

Different

A separate setting: "exclude" (the default), "include" or "only"

Selection

Averaging

plotms

visplot

Status

Notes

See

Reviewed

avgtime

scatter_avg_time

Different

Seconds or "scan", per plot. Never across a scan boundary. A raster cell instead averages what it covers

Averaging

avgchannel

scatter_avg_chan

Same

A number of channels, or "all"

Averaging

avgscan, avgfield

Not yet

Time averaging never crosses scans or fields

Averaging

avgbaseline

baseline_combine

Different

Rasters only: the baselines in a cell are combined as mean, median, maximum or coherent

Averaging

avgantenna, avgspw

Not yet

Averaging

scalar

averaging="scalar"

Same

"vector" is the default, as in plotms

Averaging

averages weighted by the data weights

Different

visplot does not use the weights: every unflagged sample counts equally

Averaging

Transformations

plotms

visplot

Status

Notes

See

Reviewed

freqframe, restfreq, veldef

Not yet

There is no velocity axis

phasecenter

Not yet

Flag extension

plotms

visplot

Status

Notes

See

Reviewed

extendflag, extcorr

flag_reach="correlations"

Same

Flagging

extchannel

flag_reach="channels"

Same

Flagging

flag_reach: baselines, spectral windows, scan, fields

(more)

Reaches plotms does not have; for a raster box with the All selected filter

Flagging

Iteration and grids

plotms

visplot

Status

Notes

See

Reviewed

iteraxis: scan, field, spw, baseline, antenna, corr

layout="grid", iterate_by

Same

Two axes can be combined ("antenna,spw")

Plots

iteraxis="time"

Not yet

Plots

gridrows, gridcols

gridrows, gridcols

Different

For iteration only (1–8). Two different plots are two panels (layout="side" or "over", panels=)

Plots

rowindex, colindex, plotindex

panels=[{...}, {...}]

Different

At most two independently configured panels

Plots

xselfscale, yselfscale, xsharedaxis, ysharedaxis

Different

A grid has a common or per-plot axis scale, set in the window; gridcolor does the same for the color range

Plots

Axes

plotms

visplot

Status

Notes

See

Reviewed

time

TIME

Same

UTC by default, or elapsed (time_labels)

Plots

chan, freq

CHANNEL, FREQUENCY

Same

Frequency is a scatter X axis; a raster’s Channel axis reads frequency across several spectral windows

Plots

vel

Not yet

amp, phase, real, imag

AMPLITUDE, PHASE, REAL, IMAGINARY

Same

Quantities

uvdist, uvwave

UVDIST, UVDIST_LAMBDA

Same

Scatter X axis

Plots

u, v

U, V

Same

U against V gives UV coverage

Plots

w, uwave, vwave, wwave

Not yet

baseline

BASELINE

Different

A raster axis, by number or by length (baseline_order)

Plots

ant1, ant2

ANTENNA1 × ANTENNA2

Different

Together, as the antenna × antenna matrix raster

Standard views

corr

Not yet

Not an axis; each raster shows one correlation or the parallel hands averaged (raster_corr), and a scatter shows correlations as layers

Plots

scan, field, spw as axes

Not yet

Available for coloring and iteration instead

flag

FLAG (raster)

Different

The flagged fraction of each cell; flagged data can also be shown (flag_show_flagged)

Quantities

wt, wtamp, wtsp, sigma, sigmasp

Not yet

Quantities

interval, row, observation, intent, feed1, feed2, flagrow

Not yet

azimuth, elevation, hourang, parang

Not yet

Plots

antenna-based and calibration axes (ant-azimuth, gainamp, delay, tsys, …)

Not yet

PHASE_RMS, COHERENCE, AMP_VDIFF, PHASE_DIFF, Z_SCORE

(more)

Quantities plotms does not have

Quantities

Display

plotms

visplot

Status

Notes

See

Reviewed

coloraxis: scan, field, spw, antenna1, antenna2, baseline

scatter layer coloring

Same

Also coloring by Z-Score

Plots

coloraxis: corr

scatter layers

Different

Each correlation is a layer in its own color

Plots

coloraxis: channel, time, observation, intent

Not yet

clearplots=False (overplot)

scatter layers

Different

Layers in one scatter plot

Plots

customsymbol, symbolshape, symbolsize, symbolcolor, …

N/A

Points are drawn as density; the colormap is selectable (scatter_cmap)

Colormaps

customflaggedsymbol, flaggedsymbolcolor, …

flag_show_flagged, flag_flagged_color

Same

Flagging

plotrange

Different

Zoom in the window; time_range / uvrange narrow the data instead

Selection

title, xlabel, ylabel, fonts, grid lines, legendposition

Not yet

Titles and legends are generated

xconnector, timeconnector

Not yet

showatm, showtsky, showimage

Not yet

Export and other

plotms

visplot

Status

Notes

See

Reviewed

plotfile (PNG)

plotfile

Same

Writes the PNG instead of opening the window

Output

expformat: jpg, pdf, ps, txt

Not yet

PNG only

Output

exprange

exprange

Same

Also page numbers, such as "1-3,5"

Output

width, height, dpi, highres

row_height, column_width

Different

Sizes per row and column of plots, in pixels

Output

showgui=False

plotfile

Different

Giving plotfile implies no window

Output

headeritems

plot description page

Different

Every setting of the plot, and the call that reproduces it

Output

callib (on-the-fly calibration)

Not yet

Locate (GUI)

cursor readout

Partial

The readout names the baseline, time and value under the pointer; there is no list of selected points

Flag / Unflag (GUI)

flag and unflag boxes

Same

With filters, preview, undo and a backup before writing

Flagging

Reload (GUI)

Reload

Same

Re-reads the data from disk

Sources