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’  
         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