NRAO Home > CASA > CASA Task Reference Manual

0.1.72 plotcal

Requires:

Synopsis
An all-purpose plotter for calibration results

Description

An all-purpose plotter for calibration results. The values for all calibration solutions (G, T, GSPLINE, B, BPOLY, D) can be displayed for a variety of polarization combinations and calibrations. The solutions may be iterated through antennas/spw/fields during one execution.



Arguments





Inputs

caltable

Name of input calibration table

allowed:

string

Default:

xaxis

Value to plot along x axis (time,chan,freq, antenna,antenna1,antenna2,scan, amp,phase,real,imag,snr, tsys,delay,spgain)

allowed:

string

Default:

yaxis

Value to plot along y axis (amp,phase,real,imag,snr, antenna,antenna1,antenna2,scan, tsys,delay,spgain)

allowed:

string

Default:

poln

Antenna polarization to plot (RL,R,L,XY,X,Y,/)

allowed:

string

Default:

field

field names or index of calibrators: ”==>all

allowed:

string

Default:

antenna

antenna/baselines: ”==>all, antenna = ’3,VA04’

allowed:

string

Default:

spw

spectral window:channels: ”==>all, spw=’1:5~57’

allowed:

string

Default:

timerange

time range: ”==>all

allowed:

string

Default:

subplot

Panel number on display screen (yxn)

allowed:

int

Default:

111

overplot

Overplot solutions on existing display

allowed:

bool

Default:

False

clearpanel

Specify if old plots are cleared or not (ignore)

allowed:

string

Default:

Auto

iteration

Iterate plots on antenna,time,spw,field

allowed:

string

Default:

plotrange

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

allowed:

doubleArray

Default:

showflags

If true, show flagged solutions

allowed:

bool

Default:

False

plotsymbol

pylab plot symbol

allowed:

string

Default:

o

plotcolor

initial plotting color

allowed:

string

Default:

blue

markersize

Size of plotted marks

allowed:

double

Default:

5.0

fontsize

Font size for labels

allowed:

double

Default:

10.0

showgui

Show plot on gui

allowed:

bool

Default:

True

figfile

”= no plot hardcopy, otherwise supply name

allowed:

string

Default:

Returns
void

Example

 
 
        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’,’scan’,’chan’,’freq’,’antenna’,’amp’,’phase’,’real’,’imag’,’snr’  
Default: cal type dependent, usually ’time’  
yaxis -- Value to plot on the y-axis  
Options: ’amp’,’phase’,’real’,’imag’,’snr’,’antenna’,’tsys’,’delay’,’spgain’  
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  
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.  
 


More information about CASA may be found at the CASA web page

Copyright 2010 Associated Universities Inc., Washington, D.C.

This code is available under the terms of the GNU General Public Lincense


Home | Contact Us | Directories | Site Map | Help | Privacy Policy | Search