ms.lister - Function

List the measurement set's data in a concise form

Synopsis
lister(starttime, stoptime)

Arguments

starttime	in	Timestamp to begin listing
		Allowed:	String
		Default:	no default
stoptime	in	Timestamp to end listing
		Allowed:	String
		Default:	no default

Description
This function provides rudimentary capabilities for listing the contents of an interferometric measurement set. It will list, in the logger, the timestamps; antenna numbers; uvdist (wavelengths at the reference frequency); field, spectral window, and channel numbers (as necessary); and the amplitude (Jy), phase (degrees), and weight for each polarization that occur within the timerange indicated in the arguments. In the current release, selection by other data parameters is unavailable (lister is not yet bound to the select, selectinit, selectchannel, and selectpolarization functions in the ms tool), but this will be added soon, along with control of the precision of the listed values, and additional listing format choices, including matrix listings and observational sequence listings. Handling of single dish measurement sets will also be provided.

Example

      include 'ms.g'
      myms := ms('3C273XC1.ms')
      myms.lister(starttime='27-Jun-1989/01:03:25',stoptime='27-Jun-1989/01:03:40');

This example will yeild the following listing in the logger (after a brief summary):

    Date/Time:                 RR:              RL:              LR:              LL:             
    1989/06/27/  Intrf UVDist     Amp   Phs  Wt    Amp   Phs  Wt    Amp   Phs  Wt    Amp   Phs  Wt
    ------------|-----|------|-----------------|----------------|----------------|----------------
      01:03:30.0  1- 2  55956: 29.169   1.6   1  1.104-115.8   1  1.860 143.7   1 28.943   1.8   1
      01:03:30.0  1- 3  28570: 31.134  -2.2   1  1.794 -90.7   1  1.505 154.5   1 31.282  -2.7   1
      01:03:30.0  1- 4  17667: 28.938  -4.3   1  2.139-111.2   1  0.433 160.7   1 28.879  -4.3   1
      01:03:30.0  1- 5  31047: 30.944   2.9   1  1.472-109.0   1  1.545 138.9   1 30.980   2.5   1
      01:03:30.0  1- 6  38520: 31.195  -1.9   1  1.550 -97.3   1  1.485 145.1   1 31.200  -1.9   1
      01:03:30.0  1- 7  69127: 30.089   1.6   1  3.415 -92.9   1  3.120 118.9   1 29.968   1.5   1
    .  
    .  
    .

For measurement sets with multiple fields, spectral windows, or channels, additional columns will be added to the listing.

Next: ms.selectinit - Function Up: ms - Tool Previous: ms.range - Function Contents Index

	Package	general
	Module	ms
	Tool	ms