Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

calibrater.plotcal - Function

	Package	synthesis
	Module	calibrater
	Tool	calibrater

Plot a calibration table

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

Arguments

plottype	in	Plot type
		Allowed:	String from 'AMP'|'1/AMP'|'PHASE'|'RLPHASE'|'XYPHASE'|'RI'|'DAMP'|'DPHASE'|'DRI'|'FIT'|'FITWGT'|'TOTALFIT'
		Default:	'AMP'
tablename	in	Calibration table name
		Allowed:	String
		Default:	''
antennas	in	Antennas to plot
		Allowed:	Vector of Ints
		Default:	[]
fields	in	Fields to plot
		Allowed:	Vector of Ints
		Default:	[]
polarization	in	Polarization to plot
		Allowed:	Integer
		Default:	1
spwids	in	Spectral windows id.'s to plot
		Allowed:	Vector of Ints
		Default:	[]
multiplot	in	Turn on separate antenna plots
		Allowed:	Bool
		Default:	F
nx	in	If multiplot=T, number of plots on horizontal axis
		Allowed:	Integer
		Default:	1
ny	in	If multiplot=T, number of plots on vertical axis
		Allowed:	Integer
		Default:	1
psfile	in	name of output PostScript file. Empty string causes plot to be sent to the screen
		Allowed:	string
		Default:	''

Returns
Bool

Description

This function plots a calibration table either to a plotter or to a file.

The argument plottype can take the following values 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 argument plottype can take the following values for D tables

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.

For B solutions, the plotting will loop over timestamps (if more than one).

A hardcopy plot can be created by specifying the psfile argument (which is especially useful for batch processing when a display screen is not available). This will cause the plot to be written to a PostScript file which can be subsequently sent to a printer.

Example

c:=calibrater('3C273XC1.MS');
c.plotcal(plottype='PHASE', tablename="gcal", antennas=[1,3], polarization=2);
c.close();