|
|
|||
| NRAO Home > CASA > CASA Task Reference Manual |
|
||
0.1.59 listobs
Requires:
Synopsis
List the summary of a data set in the logger or in a file
Description
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).
Lists the following properties of a measurement set: scan list, field list, spectral
window list with correlators, antenna locations, ms table information.
Arguments
| Inputs |
| ||
| vis |
| Name of input visibility file (MS)
| |
| allowed: | string |
|
| Default: |
| |
| selectdata |
| Data selection parameters
| |
| allowed: | bool | |
| Default: | True |
|
| spw |
| spectral-window/frequency/channel
| |
| allowed: | any |
|
| Default: | variant
|
|
| field |
| Field names or field index numbers: ”==>all,
field=’0~2,3C286’
| |
| allowed: | any |
|
| Default: | variant
|
|
| antenna |
| antenna/baselines: ”==>all, antenna =’3,VA04’
| |
| allowed: | any |
|
| Default: | variant
|
|
| uvrange |
| uv range: ”==>all; uvrange =’0~100klambda’, default
units=meters | |
| allowed: | any |
|
| Default: | variant
|
|
| timerange |
| time range: ”==>all,timerange=’09:14:0~09:54:0’
| |
| allowed: | any |
|
| Default: | variant
|
|
| correlation |
| Select data based on correlation
| |
| allowed: | any |
|
| Default: | variant
|
|
| scan |
| scan numbers: ”==>all
| |
| allowed: | any |
|
| Default: | variant
|
|
| intent |
| Select data based on observation intent: ”==>all
| |
| allowed: | any |
|
| Default: | variant
|
|
| feed |
| multi-feed numbers: Not yet implemented
| |
| allowed: | any |
|
| Default: | variant
|
|
| array |
| (sub)array numbers: ”==>all
| |
| allowed: | any |
|
| Default: | variant
|
|
| observation |
| Select data based on observation ID: ”==>all
| |
| allowed: | any |
|
| Default: | variant
|
|
| verbose |
| ||
| allowed: | bool |
|
| Default: | True |
|
| listfile |
| Name of disk file to write output: ”==>to terminal
| |
| allowed: | string |
|
| Default: |
|
|
void
Example
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.
More information about CASA may be found at the
CASA web page
Copyright © 2010 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