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