Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

bimacalibrater.plotcal - Function

	Package	bima
	Module	bimacalibrater
	Tool	bimacalibrater

Plot a calibration table(s)

Synopsis
plotcal(sources, plottype, tablename, antennas, fields, polarization, spwids, timeslot, multiplot, nx, ny, psfile)

Description

This function is a wrapper around the calibrater tool's plotcal() function which plots calibration tables. calibrater.plotcal() is run seperately on each source specified by the sources parameter.

The following plottype choices are currently available for all types of solutions:

AMP

Gain Amplitude vs. Time

1/AMP

Inverse Gain Amplitude vs. Time (useful for comparing with classic AIPS)

PHASE

Gain Phase vs. Time

RI

Gain Real vs. Imaginary

RLPHASE

Right/Left Gain phase difference (if polarizations are R,L)

XYPHASE

X/Y Gain phase difference (if polarizations are X,Y)

The following plottype choices are currently available for D solutions:

DAMP

Cross-polarized Gain Amplitude vs. Time

DPHASE

Cross-polarized Gain Phase vs. Time

DRI

Cross-polarized Gain Real vs. Imaginary

The quality of the solutions can be examined with the following plottype choices:

FIT

Fit per spectral window

FITWGT

Fit weight per spectral window

TOTALFIT

Total fit

By default, all antennas (as specified in the antennas argument) will appear on the same plot. Separate plots (all with the same scale) for each antenna can be activated by setting multiplot=T. The multiplot argument only separates plots by antenna (not, e.g., by the field_id(s) specified in the fields argument). If multiplot=T, the nx and ny arguments can be used to specify the number of plots per page.

At the moment, only one polarization can be plotted per execution. This restriction will be relaxed in the near future.

Arguments

sources		Nicknames of sources on which to run calibrater.plotcal()
		Allowed:	Vector of strings (nicknames or roles of sources)
		Default:	none
plottype		Plot type
		Allowed:	String
		Default:	'AMP'
tablename		Calibration table name
		Allowed:	String
		Default:	''
antennas		Antennas to plot
		Allowed:	Vector of Ints
		Default:	False
fields		Fields to plot
		Allowed:	Vector of Ints
		Default:	False
polarization		Polarization to plot
		Allowed:	Integer
		Default:	1
spwids		Spectral windows id.'s to plot
		Allowed:	Vector of Ints
		Default:	False
timeslot		Timeslot index for B Jones
		Allowed:	Integer
		Default:	1
multiplot		Turn on separate antenna plots
		Allowed:	Bool
		Default:	F
nx		If multiplot=T, number of plots on horizontal axis
		Allowed:	Integer
		Default:	1
ny		If multiplot=T, number of plots on vertical axis
		Allowed:	Integer
		Default:	1
psfile		name of output PostScript file to write plot to
		Allowed:	String
		Default:	empty string, causing plot to be sent to the screen

Returns
Boolean or fail

Example

- bc := bimacalibrater(['sgrb2.ms','sgra.ms'],
+ '1733-130.ms',targetnames=['sgrb','sgra'],phcalnames='1733'); 
- bc.setjy(fluxdensity=[5,0,0,0]);
T
- bc.setdata('1733',mode='channel');
T
- bc.setsolve('1733','G',60,refant=4,table='gcal');
T
- bc.solve()
T
- bc.plotcal('1733',plottype='phase',table='gcal',antennas=[1,3]);
T
- bc.close('1733');
T