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