This task 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, float_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         Time stamp of data sample (YYMMDD/HH:MM:SS UT)  
Intrf             Interferometer baseline (antenna names)  
UVDist            uv-distance (units of wavelength)  
Fld               Field ID (if more than 1)  
SpW               Spectral Window ID (if more than 1)  
Chn               Channel number (if more than 1)  
(Correlated       Correlated polarizations (eg: RR, LL, XY)  
  polarization)     Sub-columns are: Amp, Phs, Wt, F  
Amp               Visibility amplitude  
Phs               Visibility phase (deg)  
Wt                Weight of visibility measurement  
F                 Flag: ’F’ = flagged datum; ’ ’ = unflagged  
UVW               UVW coordinates (meters)  
 
 
Input Parameters:  
vis         Name of input visibility file  
            default: none; example: vis=’ngc5921.ms’  
 
options     List options: default = ’ap’  
            Not yet implemented for suboptions  
 
datacolumn  Visibility file data column:  
            default = ’data’:  options are  
            data, float_data, corrected, model, residual (corrected-model)  
 
field       Select data based on field id(s) or name(s)  
            default: ’’==>all; example: field=’1’  
            field=’0~2’ field ids inclusive from 0 to 2  
            field=’3C*’ all field names starting with 3C  
 
spw         Select spectral window, channel to list  
            default: ’0:0’ --> spw=0, chan=0  
            spw=’2:34’ spectral window 2, channel 34  
 
selectdata  Toggle the following 7 selection parameters.  
            default: False; example: selectdata=True  
            If false, the following parameters are reset  
            to default values.  
 
      antenna     Select calibration data based on antenna  
                  default: ’’-->all; examples:  
                  antenna = ’5,6’; antenna index 5 and 6 solutions  
                  antenna = ’05,06’; antenna names ’05’ and ’06 solutions  
 
      timerange   Select time range to list  
                  default: ’’-->all; examples:  
                  timerange=’10:37:50.1’; list data for this sampling interval  
                  timerange=’<10:37:25’; list data before 10:37:25  
 
      correlation Select polarization correlations to list  
                  default: ’’-->all; examples:  
                  correlation=’RR LL’; list RR and LL correlations  
                  correlation=’XX XY’; list XX and XY correlations  
 
      scan        Select scans to list  
                  default: ’’-->all; examples:  
                  scan=’2’; list scan 2  
                  scan=’>2’; list scan numbers greater than 2  
 
      feed        (not yet implemented)  
 
      array       (not yet implemented)  
 
      observation Select by observation ID(s).  
                  default: ’’-->all;  
  example: observation=’0’ (select obsID 0)  
 
      uvrange     Select baseline lengths to list.  
                  default: ’’--> all; examples:  
                  uvrange=’<5klambda’; less than 5 kilo-wavelengths  
                  Caution: Input units default to meters.  
                  Listed units are always wavelengths.  
 
average     (not yet implemented)  
 
showflags   (not yet implemented)  
 
pagerows    rows per page of listing  
            default: 50; 0 --> do not paginate  
 
listfile    write output to disk; will not overwrite  
            default: ’’ --> write to screen  
            listfile = ’solutions.txt’  
 
async       Run asynchronously  
            default = False; do not run asychronously