|
|
(2 intermediate revisions by one other user not shown) |
Line 1: |
Line 1: |
| == Help on plotxy task: ==
| | {{plotxy}} |
| | |
| <pre>
| |
| An X-Y plotter/interactive flagger for visibility data.
| |
| | |
| An X-Y plotter/interactive flagger for visibility data.
| |
| | |
| Selected data can be flexibly plotted with a wide variety
| |
| of axes and averaging options, including iteration over
| |
| antennas and fields. Data may be listed, flagged or
| |
| unflagged interactively. The plots can be zoomed and
| |
| also saved to a file.
| |
| | |
| It is advisable to run flagmanager before using plotxy to
| |
| flag data in order to save the current flag state before
| |
| altering:
| |
| flagmanager(vis='vis_name',mode='save',versionname='before_plotxy',
| |
| comment=versionname)
| |
| | |
| See hints on using plotxy at the end.
| |
| | |
|
| |
| Keyword arguments:
| |
| vis -- Name of input visibility file
| |
| default: none. example: vis='ngc5921.ms'
| |
| xaxis -- Visibility data to plot along the x-axis
| |
| default: 'time'
| |
| | |
| Options for BOTH x-axis and y-axis
| |
| 'time','uvdist','chan', 'corr','freq','velo', 'u','v','w',
| |
| 'azimuth','elevation','baseline','hourangle','parallacticangle'
| |
| 'amp','phase','real','imag','weight'. 'x' gives antenna array
| |
|
| |
| yaxis -- Visibility data to plot along the y-axis
| |
| default: 'amp'
| |
| Options: same as on xaxis:
| |
| | |
| >>> yaxis expandable parameter
| |
| datacolumn -- Visibility file data column
| |
| Note: this parameter is automatically shown whenever the
| |
| chosen yaxis is a data quantity (i.e. amp)
| |
| default: 'data'; example: datacolumn='model'
| |
| Options: 'data' (raw),'corrected','model','residual'(corrected-model)
| |
| | |
| --- Data Selection (see help par.selectdata for more detailed information)
| |
| | |
| field -- Select field using field id(s) or field name(s).
| |
| ['go listobs' to obtain the list id's or names]
| |
| default: ''=all fields
| |
| If field string is a non-negative integer, it is assumed to
| |
| be a field index otherwise, it is assumed to be a field name
| |
| field='0~2'; field ids 0,1,2
| |
| field='0,4,5~7'; field ids 0,4,5,6,7
| |
| field='3C286,3C295'; field named 3C286 and 3C295
| |
| field = '3,4C*'; field id 3, all names starting with 4C
| |
| spw -- Select spectral window/channels
| |
| spw='0~2,4'; spectral windows 0,1,2,4 (all channels)
| |
| spw='<2'; spectral windows less than 2 (i.e. 0,1)
| |
| spw='0:5~61'; spw 0, channels 5 to 61, INCLUSIVE
| |
| spw='*:5~61'; all spw with channels 5 to 61
| |
| spw='0,10,3:3~45'; spw 0,10 all channels, spw 3, channels 3 to 45.
| |
| spw='0~2:2~6'; spw 0,1,2 with channels 2 through 6 in each.
| |
| spw='0:0~10;15~60'; spectral window 0 with channels 0-10,15-60
| |
| NOTE ';' to separate channel selections
| |
| spw='0:0~10^2,1:20~30^5'; spw 0, channels 0,2,4,6,8,10,
| |
| spw 1, channels 20,25,30
| |
| selectdata -- Other data selection parameters
| |
| default: True
| |
| >>> selectdata expandable parameters
| |
| timerange -- Select data based on time range:
| |
| default = '' (all); examples,
| |
| timerange = 'YYYY/MM/DD/hh:mm:ss~YYYY/MM/DD/hh:mm:ss'
| |
| Note: if YYYY/MM/DD is missing date defaults to first day in data set
| |
| timerange='09:14:0~09:54:0' picks 40 min on first day
| |
| timerange= '25:00:00~27:30:00' picks 1 hr to 3 hr 30min on next day
| |
| timerange='09:44:00' data within one integration of time
| |
| timerange='>10:24:00' data after this time
| |
| antenna -- Select data based on antenna/baseline
| |
| default: ''=all
| |
| If antenna string is a non-negative integer, it is assumed
| |
| to be an antenna index, otherwise it is assumed to be an
| |
| antenna name
| |
| antenna='5&6'; baseline between antenna index 5 and index 6.
| |
| antenna='VA05&VA06'; baseline between VLA antenna 5 and 6.
| |
| antenna='5&6;7&8'; baseline 5-6 and 7-8
| |
| antenna='5'; all baselines with antenna index 5
| |
| antenna= '05'; all baselines with antenna named 05
| |
| antenna='5,6,9'; all baselines with antennas indices 5,6 and 9
| |
| correlation -- Select correlations:
| |
| default: '' = all correlations. Other options are any combination
| |
| of values from one of the valid lists:
| |
| 'RR','LL','RL','LR','RR LL','RL LR',
| |
| 'XX','YY','XY','YX','XX YY','XY YX'
| |
| uvrange -- Select data within uvrange (default units meters)
| |
| default: ''=all; example:
| |
| uvrange='0~1000klambda'; uvrange from 0-1000 kilo-lambda
| |
| uvrange='>4klambda';uvranges greater than 4 kilo-lambda
| |
| uvrange='0~1000km'; uvrange in kilometers
| |
| scan -- Scan number range
| |
| array -- (Sub)-array number range - under development
| |
| feed -- Multi-feed number range - under development
| |
|
| |
| averagemode -- Select average mode
| |
| default: 'vector'
| |
| Options: 'vector' = average over real and image part separately.
| |
| 'scalar' = scalar average of amplitude, vector
| |
| average of the phase.
| |
| '' = no averaging
| |
| >>> averagemode expandable parameters
| |
| timebin -- length of time intervals to average
| |
| default: '0'= no time averaging
| |
| example: timebin='60' (average over 60 second interval).
| |
| example: timebin='all' (all times obeying other selection
| |
| parameters, i.e. timerange and crossscans)
| |
| crossscans -- Have time averaging cross scan boundaries?
| |
| default: False=time averaging does not cross scan boundaries
| |
| crossbls -- Have averaging cross baseline boundaries?
| |
| default: False= averaging does not cross baseline boundaries
| |
| crossarrays -- Have averaging cross array boundaries?
| |
| default: False=averaging does not cross array boundaries
| |
| stackspw -- Stack multiple spw on top of each other?
| |
| default: False= layout spws side-by-side for xaxis='channel'
| |
| width -- number of channels to average
| |
| default: '1'= no channel averaging
| |
| example: width='32' (average 32 channels together).
| |
| example: width='all' (all channels within each selected spw)
| |
| example: width='allspw' (all channels and all spw averaged.)
| |
| restfreq -- Set rest frequency or transition name
| |
| options: (str) '' a frequency quanta or transition name
| |
| default: currently set rest frequency and frame in MS
| |
| see measures for known lines, e.g.
| |
| me.linelist() to list lines
| |
| me.me.spectralline to get frequency
| |
| example: restfreq='1420405751.786Hz' 21cm HI frequency
| |
| restfreq='HI' 21cm HI transition name
| |
| restfreq='115.2712GHz' CO line
| |
| >>> restfreq expandable parameters
| |
| frame -- frequency frame for spectral axis
| |
| options: (str) 'LSRK','REST','TOPO','LSRD','BARY',
| |
| 'GEO','GALACTO','LGROUP','CMB'
| |
| default: currently set frequency frame in MS
| |
| see measures (me.frequency) for description
| |
| doppler -- doppler mode
| |
| options: (str) 'RADIO','Z','RATIO','BETA','GAMMA',
| |
| 'OPTICAL','TRUE','RELATIVISTIC'
| |
| default: currently set doppler system in MS
| |
| see measures (me.doppler) for description
| |
| extendflag -- flagging extension parameters
| |
| default: False= no extension, only flag selected data;
| |
| example: extendflag=True
| |
| >>> extendflag expandable parameters
| |
| extendcorr -- Extend flagging based on correlation:
| |
| default: ''= no correlation based extension
| |
| examples:
| |
| extendcorr = 'all'
| |
| extendcorr = 'half' flags RR and LL
| |
| extendchan -- Extend flagging based on channel:
| |
| default: ''= no channel based extension
| |
| example:
| |
| extendchan = 'all'
| |
| extendspw -- Extend flagging based on spectral window:
| |
| default: '' = no spectral window based extension
| |
| example:
| |
| extendspw = 'all'
| |
| extendant -- Extend flagging based on antenna (baseline):
| |
| default: ''= no antenna based extension
| |
| example:
| |
| extendant = 'all'
| |
| extendtime -- Extend flagging based on time:
| |
| default: ''= no time based extension
| |
| example:
| |
| extendant = 'all'
| |
| subplot -- Panel number on the display screen
| |
| default: 111 (full screen display); example:
| |
| if iteration is non-blank, then
| |
| subplot=yx1 window will produce y by x plots in the window.
| |
| if iteration = '', then
| |
| subplot=yxn; means the window will have y rows, and x columns
| |
| with the present execution placing the plot in location n
| |
| n = 1,..., xy, in order upper left to right, then down. An
| |
| example is the plotting of four fields on one frame
| |
| field='0'; subplot=221; plotxy()
| |
| field='1'; subplot=222; plotxy()
| |
| field='2'; subplot=223; plotxy()
| |
| field='3'; subplot=224; plotxy()
| |
| overplot -- Overplot on current plot (if possible)
| |
| default: False; example: overplot= True
| |
| showflags -- Show the flagged and unflagged data.
| |
| default: False; example: showflags=True
| |
| iteration -- Iterate plots:
| |
| default: ''; no iteration
| |
| Options: 'field', 'antenna', 'baseline'.
| |
| Use the 'NEXT' button on gui to iterate through values.
| |
| To abort an iteration, close the gui window.
| |
| plotsymbol -- plot symbol. (Options include .:,o^v><s+xDd234hH|_ or
| |
| optionally preceded by one of color code k, r, g, b, c, y)
| |
| default: '.': points, medium-sized dots
| |
| example: plotsymbol='bo' (blue points, large-sized dots
| |
| r=red, b=blue, g=green, y=yellow
| |
| ',' = small points
| |
| '.' = medium points
| |
| 'o' = large points
| |
| plotcolor -- color. Overrides plotsymbol color settings.
| |
| default: 'darkcyan'
| |
| example: plotcolor='g' (green)
| |
| plotcolor='slateblue'
| |
| plotcolor='#7FFF34' (RGB tuple)
| |
| multicolor -- Multi-color plotting of channels and correlations
| |
| options: 'none','both','chan','corr'
| |
| default: 'corr'; example: multicolor='chan'
| |
| plotrange -- Specifies the size of the plot [xmin, xmax, ymin, ymax]
| |
| default: [0,0,0,0]; Range is self-selected
| |
| example: [0,0,0.00,0.20] only y axis is specified
| |
| To use a time range (NOTE: somewhat different sytax from timerange
| |
| ['22:23:24, 23:42:20', 0.02, 0.20]
| |
| The day must be included if the visibility data span more than one day
| |
| ['1997/05/09/22:02:00, 1997/05/09/23:00:00', 0.02, 0.20]
| |
| selectplot -- Additional plot control parameters
| |
| default: False; example: selectplot=true
| |
| >>> selectplot expandable parameters
| |
| markersize -- Size of the plotted marks
| |
| default: 5.0; example: markersize=10.0
| |
| linewidth -- Width of plotted lines.
| |
| default: 1; example: linewidth=2.0
| |
| skipnrows -- # of points to skip
| |
| default: 0
| |
| example: skipnrows=100 (plots every 100th point)
| |
| newplot -- When overplotting, replace the last plot only
| |
| default: False; can be useful when doing subplots
| |
| clearpanel -- Clear nothing on the plot window, automatically
| |
| clear plotting area, clear the current plot area, or
| |
| clear the whole plot panel.
| |
| options: None, Auto, Current, All
| |
| default: Auto
| |
| example: clearpanel='Current'
| |
| title -- Plot title (above plot)
| |
| default: ''; example: title='This is my title'
| |
| xlabels -- Label for x axis
| |
| default: ''; example: xlabels='X Axis'
| |
| ylabels -- Label for y axis
| |
| default: ''; example: ylabels='Y Axis'
| |
| skipnrows -- # of points to skip
| |
| default: 0
| |
| example: skipnrows=100 (plots every 100th point)
| |
| newplot -- When overplotting, replace the last plot only
| |
| default: False; can be useful when doing subplots
| |
| clearpanel -- Clear nothing on the plot window, automatically
| |
| clear plotting area, clear the current plot area, or
| |
| clear the whole plot panel.
| |
| options: None, Auto, Current, All
| |
| default: Auto
| |
| example: clearpanel='Current'
| |
| title -- Plot title (above plot)
| |
| default: ''; example: title='This is my title'
| |
| xlabels -- Label for x axis
| |
| default: ''; example: xlabels='X Axis'
| |
| ylabels -- Label for y axis
| |
| default: ''; example: ylabels='Y Axis'
| |
| fontsize -- Font size for labels
| |
| default: 10; example: fontsize=2
| |
| windowsize -- Window size
| |
| default: 1.0; not yet implemented
| |
| interactive -- turn on/off on screen display
| |
| options: True = interactively flag data
| |
| False = direct output to a file without on screen display
| |
| default: True;
| |
| figfile -- File name to save the plotted figure to.
| |
| default: '' = do not save figure;
| |
| example: figfile='myPlot.png' save figure to png file
| |
| figfile='myPlot.txt' append plotted xy to an ascii file
| |
| | |
| Hints on using plotxy (see section 3.4 in cookbook)
| |
| | |
| Useful Buttons at bottom left:
| |
| 5th--magnifying glass. Click on this,
| |
| left mouse button rectangle drag will zoom
| |
| right mose button rectangle drag will unzoom a certain amount
| |
| 1st--restore original magnification
| |
| | |
| Useful regions just above:
| |
| Quit will terminate plotter
| |
| Next will go to next plot as specified by iteration
| |
| To flag, unflag, locate, you must click 'Mark Region' first
| |
| then make appropriate region(s)
| |
| then click flag, unflag, locate for the desired operation
| |
| plot will then refrest
| |
| </pre>
| |