NRAO Home > CASA > CASA Toolkit Reference Manual
ms.lister - Function

1.3.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.

Table column descriptions:





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




Arguments





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:

observation

Select by observation ID(s)

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:

Returns
bool

Example

 
 
 
      ms.open(’AZ136.ms’)  
      ms.lister()  
 
    These commands yeild the following listing:  
 
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.  
 

__________________________________________________________________


More information about CASA may be found at the CASA web page

Copyright 2016 Associated Universities Inc., Washington, D.C.

This code is available under the terms of the GNU General Public Lincense


Home | Contact Us | Directories | Site Map | Help | Privacy Policy | Search