polcal – Determine instrumental polarization calibrations – calibration task

Description

The complex instrumental polarization factors (D-terms) for each antenna/spwid are determined from the data for the specified calibrator sources. Previous calibrations can be applied on the fly.

Parameters

Title
Parameter	Default	Description
vis	`''`	Name of input visibility file
caltable	`''`	Name of output gain calibration table
field	`''`	Select field using field id(s) or field name(s)
spw	`''`	Select spectral window/channels
intent	`''`	Select observing intent
selectdata	`True`	Other data selection parameters
timerange	`''`	Select data based on time range
uvrange	`''`	Select data within uvrange (default units meters)
antenna	`''`	Select data based on antenna/baseline
scan	`''`	Scan number range
observation	`''`	Select by observation ID(s)
msselect	`''`	Optional complex data selection (ignore for now)
solint	`'inf'`	Solution interval
combine	`'obs,scan'`	Data axes which to combine for solve (obs, scan, spw, and/or field)
preavg	`float(300.0)`	Pre-averaging interval (sec)
refant	`''`	Reference antenna name(s)
minblperant	`int(4)`	Minimum baselines _per antenna required for solve
minsnr	`float(3.0)`	Reject solutions below this SNR
poltype	`'D+QU'`	Type of instrumental polarization solution (see help)
smodel	`numpy.array( [ ] )`	Point source Stokes parameters for source model.
append	`False`	Append solutions to the (existing) table
docallib	`False`	Use callib or traditional cal apply parameters
callib	`''`	Cal Library filename
gaintable	`numpy.array( [ ] )`	Gain calibration table(s) to apply
gainfield	`numpy.array( [ ] )`	Select a subset of calibrators from gaintable(s)
interp	`numpy.array( [ ] )`	Interpolation mode (in time) to use for each gaintable
spwmap	`[ ]`	Spectral window mappings to form for gaintable(s)

Parameter Explanations

vis

''

Name of input visibility file

caltable

''

Name of output gain calibration table

field

''

Select field using field id(s) or field name(s)

spw

''

Select spectral window/channels

intent

''

Select observing intent

selectdata

True

Other data selection parameters

timerange

''

Select data based on time range

uvrange

''

Select data within uvrange (default units meters)

antenna

''

Select data based on antenna/baseline

scan

''

Scan number range

observation

''

Select by observation ID(s)

msselect

''

Optional complex data selection (ignore for now)

solint

'inf'

Solution interval

combine

'obs,scan'

Data axes which to combine for solve (obs, scan, spw, and/or field)

preavg

float(300.0)

Pre-averaging interval (sec)

refant

''

Reference antenna name(s)

minblperant

int(4)

Minimum baselines _per antenna required for solve

minsnr

float(3.0)

Reject solutions below this SNR

poltype

'D+QU'

Type of instrumental polarization solution (see help)

smodel

numpy.array( [ ] )

Point source Stokes parameters for source model.

append

False

Append solutions to the (existing) table

docallib

False

Use callib or traditional cal apply parameters

callib

''

Cal Library filename

gaintable

numpy.array( [ ] )

Gain calibration table(s) to apply

gainfield

numpy.array( [ ] )

Select a subset of calibrators from gaintable(s)

interp

numpy.array( [ ] )

Interpolation mode (in time) to use for each gaintable

spwmap

[ ]

Spectral window mappings to form for gaintable(s)

Only used if callib=False default: [] (apply solutions from each calibration spw to the same MS spw only) Any available calibration spw can be mechanically mapped to any

MS spw.

Examples:

spwmap=[0,0,1,1] means apply calibration: from cal spw = 0 to MS spw 0,1 and cal spw 1 to MS spws 2,3.
spwmap=[[0,0,1,1],[0,1,0,1]] (use a list of lists for multiple: gaintables)