Plotcal: Difference between revisions

From CASA Guides
Jump to navigationJump to search
m (moved Plotcal to plotcal: Converting page titles to lowercase)
(Replaced content with "{{plotcal}}")
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
== Help on plotcal task: ==
{{plotcal}}
 
<pre>
An all-purpose plotter for calibration results
       
        The values for all calibration solutions (G, T, GSPLINE, B, BPOLY, D, M)
        can be displayed for a variety of polarization combinations and calibrations.
        The plot solutions may be iterated through antennas/spw/fields during one execution,
        and many frames can be obtained in each plot.
 
        The plotter permits zooming, listing and flagging of solutions, although
        the results of flagged solutions are not yet available.
 
 
        The plotter permits zooming, listing and flagging of solutions, although
        the implications of flagged solutions are not yet made.  See some hints at the end
        of this description.
 
 
        Keyword arguments:
        caltable -- Name of input calibration table
                default: none; example: caltable='ngc5921.gcal'
                The type of calibration table is determined automatically.
        xaxis -- Value to plot on the x axis
                Options: 'time','chan','freq','antenna','amp','phase','real','imag','snr'
                Default: cal type dependent, usually 'time'
        yaxis -- Value to plot ong the y-axis
                Options: 'amp','phase','real','imag','snr','antenna'
                Default: cal type dependent, usually 'amp'
        poln -- Polarization (or combination) to plot
                default: '' (RL); all polarizations
                Options: '' = ('RL'),'R','L','XY','X','Y',
                              '/' --> form complex poln ratio
                                    (amp ratio and phase difference)
        field -- Select field using field id(s) or field name(s).
                  ['go listobs' to obtain the fieldt id's or names]
              default: ''=all fields
              If field string is a non-negative integer, it is assumed a
              field index, otherwise it is assumed 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
        antenna -- Antenna selection (baseline syntax ignored)
              default: '' (all);
              example: antenna='1,3~5' means antenna
                  indices 1,3,4,5. 
        spw -- Select spectral window (channel syntax ignored, except for D)
              default: ''=all spectral windows
              spw='0~2,4'; spectral windows 0,1,2,4
              spw='<2';  spectral windows less than 2
        timerange -- Time selection
                  default: '' (all)
                  example: timerange='1995/04/13/09:15:00~1995/04/13/09:25:00'
 
        --- Plot Options ---
        subplot -- Panel number on the display screen
              default: 111 (full screen display);
              examples:
              if iteration = 'antenna'; subplot=321 then
                  a plot frame will contain the first 6 antennas, in three
                  rows and two columns.  Follow instructions on screen to
                  cycle through the frames
              if iteration = ''; then one frame can be filled with many
                  plots in a piecemeal fashion; for example
                  antenna='0'; subplot=221; plotcal()
                  antenna='1'; subplot=222; plotcal()
                  antenna='2'; subplot=223; plotcal()
                  antenna='3'; subplot=224; plotcal()
        overplot -- Overplot these values on current plot (if possible)
              default: False;
                  True (overplotting) can be done ONLY IF iteration=''
        clearpanel -- Ignore this parameter.
                  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 (None and Auto not supported)
              default: Auto
              example: clearpanel='Current'
        iteration -- Create a sequence of plots, iterating over antenna, time,
                field, and/or spw 
              default: '' --> create in all in one plot
              example: iteration='antenna' --> create a sequence of
                        separate plots separated by antenna. Flagging cannot
                        be done in iteration mode.
        plotrange -- Control the x and y ranges of the plot, as a list of
                values, e.g., [xmin,xmax,ymin,ymax]
                default=[] --> plot will self-scale
                Note: time plotting ranges are cumbersome to use.
                      Use the zoom option
        showflags -- If true, only flagged solutions will be plotted
                default: false --> only show unflagged solutions
        plotsymbol -- pylab plot symbol.  See cookbook for details
                  default: '.': large points
                  ',' = small points (see markersize)
                  '-' = connect points by line
                  colors are cycled automatically for multi-function plots
        iteration -- Create a sequence of plots, iterating over antenna, time,
                field, and/or spw 
              default: '' --> create in all in one plot
              example: iteration='antenna' --> create a sequence of
                        separate plots separated by antenna. Flagging cannot
                        be done in iteration mode.
        plotrange -- Control the x and y ranges of the plot, as a list of
                values, e.g., [xmin,xmax,ymin,ymax]
                default=[] --> plot will self-scale
                Note: time plotting ranges are cumbersome to use.
                      Use the zoom option
        showflags -- If true, only flagged solutions will be plotted
                default: false --> only show unflagged solutions
        plotsymbol -- pylab plot symbol.  See cookbook for details
                  default: '.': large points
                  ',' = small points (see markersize)
                  '-' = connect points by line
                  colors are cycled automatically for multi-function plots
        plotcolor -- Initial color to use on each plot
                default: 'blue'
        markersize -- Control the size of plot symbols
                  default: 5.0 --> a nice size for symbols
        fontsize -- Control the font size of title (axes labels will be
                  80% of this size)
                  default: 10.0
        showgui -- Whether or not to display the plotting GUI
                  default: True; example showgui=False
        figfile -- File name to save the plotted figure to.
                  default: ''; example figfile=myPlot.png
 
        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 locate, you must click 'Mark Region' first
                then make appropriate region(s)
                then click locate to list points on logger
                DO NOT USE Flag, Unflag at the present time.
</pre>

Latest revision as of 16:29, 18 May 2015