1.2.1.0 ms.lister

1.2.1 List measurement set visibilities
Description

This tool lists measurement set visibility data under a number of input selection conditions. The measurement set data columns that can be listed are: the raw data, corrected data, model data, and residual (corrected - model) data.

The output table format is dynamic. Field, Spectral Window, and Channel columns are not displayed if the column contents are uniform. For example, if “spw = ‘1’ ” is specified, the spw column will not be displayed. When a column is not displayed, a message is sent to the logger and terminal indicating that the column values are uniform and listing the uniform value.



Column Name	Description

Date/Time	Average date and time of data sample interval
Intrf	Interferometer baseline (antenna names)
UVDist	uv-distance (units of wavelength)
Fld	Field ID
SpW	Spectral Window ID
Chn	Channel number
(Correlated	Correlated polarizations (eg: RR, LL, XY)
polarization)	Sub-columns are: Amp, Phs, Wt, F
Amp	Visibility amplitude
Phs	Visibility phase
Wt	Weight of visibility measurement
F	Flag: ‘F’ = flagged datum; ‘ ’ = unflagged


Inputs
options	Output options (not yet implemented)
	allowed:	string
	Default:
datacolumn	Column to list: data, model, corrected, residual
	allowed:	string
	Default:	data
field	Fields
	allowed:	string
	Default:
spw	Spectral Windows
	allowed:	string
	Default:
antenna	Antenna/Baselines
	allowed:	string
	Default:
timerange	Time range
	allowed:	string
	Default:
correlation	Polarization correlations
	allowed:	string
	Default:
scan	Scan
	allowed:	string
	Default:
feed	Feed (not yet implemented)
	allowed:	string
	Default:
array	Array
	allowed:	string
	Default:
uvrange	uv-distance (output units: wavelength)
	allowed:	string
	Default:
average	Average mode (not yet implemented)
	allowed:	string
	Default:
showflags	Showflags (not yet implemented)
	allowed:	bool
	Default:	false
msselect	TaQL expression
	allowed:	string
	Default:
pagerows	Rows per page
	allowed:	int
	Default:	50
listfile	Output file
	allowed:	string
	Default:

Date/Time:                         RR:                      RL:                      LR:                      LL:
2001/12/01/  Intrf UVDist Fld SpW      Amp   Phs       Wt F     Amp   Phs       Wt F     Amp   Phs       Wt F     Amp   Phs       Wt F
------------|-----|------|---|---|-------------------------|------------------------|------------------------|------------------------
  19:30:05.0  0- 1   1400   0   0:   0.002-102.7   229035 F   0.003-178.3   239694 F   0.001 136.0   208264 F   0.001 -79.7   263599 F
  19:30:05.0  0- 2   7203   0   0:   0.002 127.3   267464 F   0.001 165.0   305192 F   0.003-118.2   265174 F   0.002  16.3   307829 F
  19:30:05.0  0- 3   9621   0   0:   0.002 -55.9   179652 F   0.002 -27.1   230130 F   0.001 -94.9   199954 F   0.003 -89.3   206764 F
  19:30:05.0  0- 4   1656   0   0:   0.001 133.3   199677 F   0.002  80.6   258140 F   0.001 -35.1   224291 F   0.003  23.9   229812 F
  19:30:05.0  0- 5   3084   0   0:   0.002 -18.4   197565 F   0.001 -83.1   228541 F   0.002 -85.1   198574 F   0.002 -28.5   227381 F
  19:30:05.0  0- 6   5020   0   0:   0.001-173.2   236475 F   0.002-104.0   257575 F   0.000   0.0   223800 F   0.000-142.5   272162 F
  19:30:05.0  0- 7  12266   0   0:   0.003 -34.6   264977 F   0.002   5.3   280113 F   0.001-152.7   243383 F   0.002 -78.8   304966 F
    .
    .
    .

Notice that the channel column is not displayed. This measurement set contains only one channel; since the channel column values are uniform, the channel column is not displayed. Instead, message ”All selected data has CHANNEL = 0” is sent to the console.

ms.lister - Function