plotms – A plotter/interactive flagger for visibility data. – visualization, information,editing, manipulation, utility task

Description

Task for plotting and interacting with visibility data and calibration tables.

Plotms provides a variety of axis choices (including data column) along with selection, averaging, and transformation options for MeasurementSets. Flag extension parameters are also available for interactive flagging operations in the plotter.

All of the provided parameters can also be set using the GUI once the application has been launched or through the plotms tool (pm).

Most of the basic plotms functions will work for calibration tables. The correlation selection string may be used to select polarization in a cal table, including ratio plots (“/”). The antenna selection string is used to select antenna1 only, rather than baselines as in an MS. When plotting parameterized CalTables, such as delays, antpos, gaincurve, or opacity, plotms will currently just plot the simple parameters contained in the table, not the effective amplitudes or phases sampled at observing times, frequencies etc. BPOLY and GSPLINE tables are supported but interactive flagging is not allowed. Features currently unsupported for CalTables include averaging, transformations (velocity conversions, etc.), and some axis and selection options which do not exist in these tables. In the plotms GUI, many options irrelevant for CalTables are not hidden when interacting with a CalTable, and such settings will be ignored (when benign) or cause an error message.

Parameters

Title

Parameter	Default	Description
vis	''
gridrows	int(1)
gridcols	int(1)
rowindex	int(0)
colindex	int(0)
plotindex	int(0)
xaxis	''
xdatacolumn	''
yaxis	''
ydatacolumn	''
yaxislocation	''
selectdata	True
field	''
spw	''
timerange	''
uvrange	''
antenna	''
scan	''
correlation	''
array	''
observation	''
intent	''
feed	''
msselect	''
averagedata	True
avgchannel	''
avgtime	''
avgscan	False
avgfield	False
avgbaseline	False
avgantenna	False
avgspw	False
scalar	False
transform	True
freqframe	''
restfreq	''
veldef	'RADIO'
shift	numpy.array( [ float(0.0),float(0.0) ] )
extendflag	False
extcorr	False
extchannel	False
iteraxis	''
xselfscale	False
yselfscale	False
xsharedaxis	False
ysharedaxis	False
customsymbol	[ ]
symbolshape	'autoscaling'
symbolsize	int(2)
symbolcolor	'0000ff'
symbolfill	'fill'
symboloutline	False
coloraxis	''
customflaggedsymbol	False
flaggedsymbolshape	'circle'
flaggedsymbolsize	int(2)
flaggedsymbolcolor	'ff0000'
flaggedsymbolfill	'fill'
flaggedsymboloutline	False
plotrange	numpy.array( [  ] )
title	''
titlefont	int(0)
xlabel	''
xaxisfont	int(0)
ylabel	''
yaxisfont	int(0)
showmajorgrid	False
majorwidth	int(1)
majorstyle	''
majorcolor	'B0B0B0'
showminorgrid	False
minorwidth	int(1)
minorstyle	''
minorcolor	'D0D0D0'
showlegend	False
legendposition	''
plotfile	''
expformat	''
verbose	True
exprange	''
highres	False
dpi	int(-1)
width	int(-1)
height	int(-1)
overwrite	False
showgui	True
clearplots	True
callib	numpy.array( [  ] )
headeritems	''
showatm	False
showtsky	False

Parameter Explanations

vis

''

Input MS (or CalTable) (blank for none)

gridrows

int(1)

Number of subplot rows

gridcols

int(1)

Number of subplot columns

rowindex

int(0)

Row location of the plot (0-based)

colindex

int(0)

Column location of the plot (0-based)

plotindex

int(0)

Index to address a subplot (0-based)

xaxis

''

Plot x-axis (blank for default/current)

xdatacolumn

''

Data column to use for x-axis (blank for default/current). Note that residuals are complex (vector) differences or ratios.

yaxis

''

Plot y-axis (blank for default/current)

ydatacolumn

''

Data column to use for y-axis (blank for default/current). Note that residuals are complex (vector) differences or ratios.

yaxislocation

''

Left or right y-axis for the data (blank for default)

selectdata

True

Data selection parameters

field

''

Field names or field index numbers (blank for all)

spw

''

Spectral windows:channels (blank for all)

timerange

''

Time range (blank for all)

uvrange

''

UV range (blank for all)

antenna

''

Antenna/baselines (blank for all)

scan

''

Scan numbers (blank for all)

correlation

''

Correlations (blank for all)

array

''

(Sub)array numbers (blank for all)

observation

''

Observation IDs (blank for all)

intent

''

Observing intent (blank for all)

feed

''

Feed numbers (blank for all)

msselect

''

MS selection (blank for all)

averagedata

True

Data averaging parameters

avgchannel

''

Average over channel (blank = False, otherwise value in channels)

avgtime

''

Average over time (blank = False, otherwise value in seconds)

avgscan

False

Average over scans. Only valid with time averaging

avgfield

False

Average over fields. Only valid with time averaging

avgbaseline

False

Average over all baselines (mutually exclusive with avgantenna)

avgantenna

False

Average per antenna (mutually exclusive with avgbaseline)

avgspw

False

Average over all spectral windows

scalar

False

Scalar averaging (False=vector averaging)

transform

True

Transform data in various ways

freqframe

''

The frame in which to render frequency and velocity axes

restfreq

''

Rest frequency to use for velocity conversions

veldef

'RADIO'

The definition in which to render velocity

shift

numpy.array( [ float(0.0),float(0.0) ] )

Adjust phases by this approximate phase center shift [dx,dy] (arcsec)

extendflag

False

Extend flagging to other data points

extcorr

False

Extend flags based on correlation

extchannel

False

Extend flags based on channel

iteraxis

''

The axis over which to iterate

xselfscale

False

When True, iterated plots have a common x-axis range (scale).

yselfscale

False

When True, iterated plots have a common y-axis range (scale).

xsharedaxis

False

Iterated plots on a grid share a common external x-axis per column. Must also set xselfscale=True and gridrows>1.

ysharedaxis

False

Iterated plots on a grid share a common external y-axis per row. Must also set yselfscale=True and gridcols>1.

customsymbol

[ ]

Set a custom symbol(s) for unflagged points

symbolshape

'autoscaling'

Shape of plotted unflagged symbols

symbolsize

int(2)

Size of plotted unflagged symbols

symbolcolor

'0000ff'

Color of plotted unflagged symbols

symbolfill

'fill'

Fill type of plotted unflagged symbols

symboloutline

False

Selects outlining plotted unflagged points

coloraxis

''

Selects which data to use for colorizing

customflaggedsymbol

False

Set a custom plot symbol for flagged points

flaggedsymbolshape

'circle'

Shape of plotted flagged symbols

flaggedsymbolsize

int(2)

Size of plotted flagged symbols

flaggedsymbolcolor

'ff0000'

Color of plotted flagged symbols

flaggedsymbolfill

'fill'

Fill type of plotted flagged symbols

flaggedsymboloutline

False

Selects outlining plotted flagged points

plotrange

numpy.array( [  ] )

Plot axes ranges: [xmin,xmax,ymin,ymax]

title

''

Title written along top of plot

titlefont

int(0)

Font for plot title

xlabel

''

Text for horizontal axis. Blank for default.

xaxisfont

int(0)

Font for plot x-axis

ylabel

''

Text for vertical axis. Blank for default.

yaxisfont

int(0)

Font for plot y-axis

showmajorgrid

False

Show major grid lines

majorwidth

int(1)

Line width in pixels of major grid lines

majorstyle

''

Major grid line style

majorcolor

'B0B0B0'

Color as name or hex code of major grid lines

showminorgrid

False

Show minor grid lines

minorwidth

int(1)

Line width in pixels of minor grid lines

minorstyle

''

Minor grid line style

minorcolor

'D0D0D0'

Color as name or hex code of minor grid lines

showlegend

False

Show a legend on the plot.

legendposition

''

Legend position.

plotfile

''

Name of plot file to save automatically

expformat

''

Export format type. If not provided, plotfile extension will be used.

verbose

True

Include metadata in text export

exprange

''

Range of iteration plots to export, one plotfile per page. Multipage pdf exports are not supported.

highres

False

Use high resolution

dpi

int(-1)

DPI of exported plot

width

int(-1)

Width of exported plot

height

int(-1)

Height of exported plot

overwrite

False

Overwrite plot file if it already exists

showgui

True

Show GUI

clearplots

True

Remove any existing plots so new ones can replace them.

callib

numpy.array( [  ] )

Calibration library string or filename for on-the-fly calibration.

headeritems

''

Comma-separated list of pre-defined page header items.

showatm

False

Compute and overlay the atmospheric transmission curve

showtsky

False

Compute and overlay the sky temperature curve