casa  $Rev:20696$
 All Classes Namespaces Files Functions Variables
Functions
listobs Namespace Reference

Functions

def listobs

Function Documentation

def listobs.listobs (   vis = '',
  selectdata = True,
  spw = '',
  field = '',
  antenna = '',
  uvrange = '',
  timerange = '',
  correlation = '',
  scan = '',
  intent = '',
  feed = '',
  array = '',
  observation = '',
  verbose = True,
  listfile = '' 
)
List the summary of a data set in the logger or in a file

       List the summary information of a data set in the logger or in a file, based on
       a data selection. Only rows can be selected and printed. No in-row selection is
       possible (channel or correlation). Refer to the task listvis to list visibilites.

       Lists the following properties of a measurement set:
       scan list, field list, spectral window list with
       correlators, antenna locations, ms table information.

       Keyword arguments:
       vis -- Name of input visibility file
       default: none. example: vis='ngc5921.ms'
       
       selectdata -- Select a subset of data for flagging
            default: False
            options: True,False
            The summary listing will only apply to the specified selection.

      antenna -- Select data based on baseline
            default: '' (all); example: antenna='5&6' baseline 5-6
            antenna='5&6;7&8' #baseline 5-6 and 7-8
            antenna='5' # all cross-correlation baselines between antenna 5 and all other available
                          antennas
            antenna='5,6' # all baselines with antennas 5 and 6
            antenna='1&&1' # only the auto-correlation baselines for antenna 1
            antenna='1&&*' # cross and auto-correlation baselines between antenna 1
                                     and all other available antennas
            antenna='1~7&&&' # only the auto-correlation baselines for antennas in range 1~7
      spw -- Select data based on spectral window and channels
            default: '' (all); example: spw='1'
            spw='<2' #spectral windows less than 2
            spw='>1' #spectral windows greater than 1
      correlation -- Correlation types
            default: '' (all);
            example: correlation='RR LL'
      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
      uvrange -- Select data within uvrange (default units meters)
            default: '' (all); example:
            uvrange='0~1000klambda'; uvrange from 0-1000 kilo-lamgda
            uvrange='>4klamda';uvranges greater than 4 kilo-lambda
            uvrange='0~1000km'; uvrange in kilometers
      timerange  -- Select data based on time range:
            default = '' (all); example,
            timerange = 'YYYY/MM/DD/hh:mm:ss~YYYY/MM/DD/hh:mm:ss'
            Note: YYYY/MM/DD can be dropped as needed:
            timerange='09:14:0~09:54:0' # this time range
            timerange='09:44:00' # data within one integration of time
            timerange='>10:24:00' # data after this time
            timerange='09:44:00+00:13:00' #data 13 minutes after time
      scan -- Select data based on scan number
            default: '' (all); example: scan='>3'
      intent -- Select data based on observation intent
            default: '' (all); example: intent='*CAL*,*BAND*'
      feed -- Selection based on the feed - NOT IMPLEMENTED YET
      array -- Selection based on the antenna array
      observation -- Selection based on the observation ID
            default: '' (all); example: observation='1' or observation=1


       verbose -- level of detail
     verbose=True: (default); scan and antenna lists
     verbose=False: less information
     
       listfile -- name of disk file to write output.
       default: None. Example: listfile='list.txt'


      The 'Int (s)' column is the average of the MS's INTERVAL column
      for each scan, so in a time-averaged MS 'Int' = 9.83s more likely
      means 5 10s integrations and 1 9s integration (timebin) than 6
      9.83s integrations. 

Definition at line 13 of file listobs.py.