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
Parameter |
Default |
Description |
|---|---|---|
vis |
|
|
gridrows |
|
|
gridcols |
|
|
rowindex |
|
|
colindex |
|
|
plotindex |
|
|
xaxis |
|
|
xdatacolumn |
|
|
yaxis |
|
|
ydatacolumn |
|
|
yaxislocation |
|
|
selectdata |
|
|
field |
|
|
spw |
|
|
timerange |
|
|
uvrange |
|
|
antenna |
|
|
scan |
|
|
correlation |
|
|
array |
|
|
observation |
|
|
intent |
|
|
feed |
|
|
msselect |
|
|
averagedata |
|
|
avgchannel |
|
|
avgtime |
|
|
avgscan |
|
|
avgfield |
|
|
avgbaseline |
|
|
avgantenna |
|
|
avgspw |
|
|
scalar |
|
|
transform |
|
|
freqframe |
|
|
restfreq |
|
|
veldef |
|
|
shift |
|
|
extendflag |
|
|
extcorr |
|
|
extchannel |
|
|
iteraxis |
|
|
xselfscale |
|
|
yselfscale |
|
|
xsharedaxis |
|
|
ysharedaxis |
|
|
customsymbol |
|
|
symbolshape |
|
|
symbolsize |
|
|
symbolcolor |
|
|
symbolfill |
|
|
symboloutline |
|
|
coloraxis |
|
|
customflaggedsymbol |
|
|
flaggedsymbolshape |
|
|
flaggedsymbolsize |
|
|
flaggedsymbolcolor |
|
|
flaggedsymbolfill |
|
|
flaggedsymboloutline |
|
|
plotrange |
|
|
title |
|
|
titlefont |
|
|
xlabel |
|
|
xaxisfont |
|
|
ylabel |
|
|
yaxisfont |
|
|
showmajorgrid |
|
|
majorwidth |
|
|
majorstyle |
|
|
majorcolor |
|
|
showminorgrid |
|
|
minorwidth |
|
|
minorstyle |
|
|
minorcolor |
|
|
showlegend |
|
|
legendposition |
|
|
plotfile |
|
|
expformat |
|
|
exprange |
|
|
highres |
|
|
dpi |
|
|
width |
|
|
height |
|
|
overwrite |
|
|
showgui |
|
|
clearplots |
|
|
callib |
|
|
headeritems |
|
|
showatm |
|
|
showtsky |
|
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
Iterated plots share a common x-axis label per column
yselfscale
False
Iterated plots share a common y-axis label per row
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.
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