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	''
xframe	''
xinterp	''
yaxis	''
ydatacolumn	''
yframe	''
yinterp	''
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
xconnector	''
timeconnector	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
showimage	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 unspecified residuals are complex (vector) differences or ratios.

xframe

''

Coordinate frame to use for x-axis

xinterp

''

Interpolation method for x-axis

yaxis

''

Plot y-axis (blank for default/current)

ydatacolumn

''

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

yframe

''

Coordinate frame to use for y-axis

yinterp

''

Interpolation method for y-axis

yaxislocation

''

Location of the y-axis (blank for default: left)

selectdata

True

Enable data selection parameters

field

''

Field names or ids (blank for all)

spw

''

Spectral windows:channels (blank for all)

timerange

''

Time range (blank for all)

uvrange

''

UV range (blank for all)

antenna

''

Baseline/antenna names or ids (blank for all)

scan

''

Scan numbers (blank for all)

correlation

''

Correlations/polarizations (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

''

MSSelection TaQL string (blank for none)

averagedata

True

Enable 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

Enable data transformations

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 not plotted

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

[ ]

Enable custom symbol(s) for unflagged points

symbolshape

'autoscaling'

Shape of plotted unflagged symbols

symbolsize

int(2)

Size of plotted unflagged symbols

symbolcolor

'0000ff'

Color (name or hex code) of plotted unflagged symbols

symbolfill

'fill'

Fill type of plotted unflagged symbols

symboloutline

False

Outline plotted unflagged symbols

coloraxis

''

Selects data axis for colorizing

customflaggedsymbol

False

Enable custom symbol(s) for flagged points

flaggedsymbolshape

'circle'

Shape of plotted flagged symbols

flaggedsymbolsize

int(2)

Size of plotted flagged symbols

flaggedsymbolcolor

'ff0000'

Color (name or hex code) of plotted flagged symbols

flaggedsymbolfill

'fill'

Fill type of plotted flagged symbols

flaggedsymboloutline

False

Outline plotted flagged symbols

xconnector

''

Set connector for data points (blank=”none”; “line”,”step”)

timeconnector

False

Connect points by time rather than x-axis

plotrange

numpy.array( [  ] )

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

title

''

Title at top of plot

titlefont

int(0)

Font size for plot title

xlabel

''

Text for horizontal x-axis. Blank for default.

xaxisfont

int(0)

Font size for x-axis label

ylabel

''

Text for vertical y-axis. Blank for default.

yaxisfont

int(0)

Font size for y-axis label

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 (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 (name or hex code) of minor grid lines

showlegend

False

Show a legend on the plot.

legendposition

''

Legend position, default upperRight.

plotfile

''

Name of plot file to save automatically

expformat

''

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

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 in pixels of exported plot

height

int(-1)

Height in pixels 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

showimage

False

Compute and overlay the image sideband curve