nraonrao
 
NRAO Home > CASA > TaskRef

0.1.72 split

Requires:

Synopsis Create a visibility subset from an existing visibility set Description

Split is the general purpose program to make a new data set that is a subset of an existing data set. General selection parameters are included, and any combination of the three data columns (data, model and/or corrected) can be selection.

Split is often used after the initial calibration of the data to remove those sources which need additional flagging, imaging and self-calibration. The data can be averaged over specified frequency channels of the input data set and time averaging is also available.

Note: It is not yet possible to simultaneously average a data set in time and frequency in one execution: they must be done separately.

Arguments





Inputs

vis

Name of input measurement set

allowed:

string

Default:

outputvis

Name of output measurement set

allowed:

string

Default:

datacolumn

Which data column to split out

allowed:

string

Default:

corrected

field

Select field using field id(s) or field name(s)

allowed:

any

Default:

variant

spw

Select spectral window/channels

allowed:

any

Default:

variant

width

Number of channels to average to form one output channel

allowed:

any

Default:

variant 1

antenna

Select data based on antenna/baseline

allowed:

any

Default:

variant

timebin

Value for timeaveraging

allowed:

string

Default:

0s

timerange

Select data based on time range

allowed:

string

Default:

scan

select data based on scan numbers

allowed:

string

Default:

array

Select (sub)array by array ID number(s)

allowed:

string

Default:

uvrange

select data based on uv distance range

allowed:

string

Default:

Example

 
 
 
     Split is the general purpose program to make a new data set  
     that is a subset of an existing data set.  General selection parameters  
     are included, and any combination of the three data columns (data, model  
     and/or corrected) can be selection.  
 
     Split is often used after the initial calibration of the data to remove those  
     sources which need additional flagging, imaging and self-calibration.  The data  
     can be averaged over specified frequency channels of the input data set and time  
     averaging is also available.  
 
    Note: It is not yet possible to simultaneously average a data set in time and frequency  
    in one execution:  they must be done separately.  
 
 
        Keyword arguments:  
        vis -- Name of input visibility file  
                default: none; example: vis=’ngc5921.ms’  
        outputvis -- Name of output visibility file  
                default: none; example: outputvis=’ngc5921_src.ms’  
 
        datacolumn -- Which data column to split out  
                default=’corrected’; example: datacolumn=’data’  
                Options: ’data’, ’model’, ’corrected’, ’all’,  
                ’data,model’,’data,corrected’,’model,corrected’,  
                note: ’all’=’data,model,corrected’  
 
        --- Data Selection (see help par.selectdata for more detailed information)  
 
        field -- Select field using field id(s) or field name(s).  
                  [run listobs to obtain the list id’s or names]  
               default: ’’=all fields  
               If field string is a non-negative integer, it is assumed a field index  
                 otherwise, it is assumed a field name  
               field=’0~2’; field ids 0,1,2  
               field=’0,4,5~7’; field ids 0,4,5,6,7  
               field=’3C286,3C295’; field named 3C286 adn 3C295  
               field = ’3,4C*’; field id 3, all names starting with 4C  
        spw -- Select spectral window/channels  
               default: ’’=all spectral windows and channels  
               spw=’0~2,4’; spectral windows 0,1,2,4 (all channels)  
               spw=’<2’;  spectral windows less than 2 (i.e. 0,1)  
               spw=’0:5~61’; spw 0, channels 5 to 61  
               spw=’0,10,3:3~45’; spw 0,10 all channels, spw 3, channels 3 to 45.  
               spw=’0~2:2~6’; spw 0,1,2 with channels 2 through 6 in each.  
               spw = ’*:3~64’  channels 3 through 64 for all sp id’s  
                       spw = ’ :3~64’ will NOT work.  
               spw = ’*:0;60~63’  channel 0 and channels 60,61,62,63 for all IF’s  
                      ’;’ needed to separate different channel ranges in one spw  
               spw=’0:0~10;15~60’; spectral window 0 with channels 0-10,15-60  
               spw=’0:0~10,1:20~30,2:1;2;4’; spw 0, channels 0-10,  
                        spw 1, channels 20-30, and spw 2, channels, 1,2 and  
width -- Defines the number of channel to average to form the one  
         output channel.  
 default: ’1’ => no channel averaging  
 example: width=[2,3] => average 2 channels of 1st  
          spectral window selected and 3 in the second one.  
        antenna -- Select data based on antenna/baseline  
               default: ’’ (all)  
               If antenna string is a non-negative integer, it is assumed an antenna index  
                 otherwise, it is assumed as an antenna name  
               antenna=’5&6’; baseline between antenna index 5 and index 6.  
               antenna=’VA05&VA06’; baseline between VLA antenna 5 and 6.  
               antenna=’5&6;7&8’; baseline 5-6 and 7-8  
               antenna=’5’; all baselines with antenna 5  
               antenna=’5,6,10’; all baselines with antennas 5 and 6  
        timebin -- Value for time averaging.  
                default=’0s’ (no averaging); example: timebin=’30s’  
                example ’10’ means ’10s’  
        timerange  -- Select data based on time range:  
               default = ’’ (all); examples,  
               timerange = ’YYYY/MM/DD/hh:mm:ss~YYYY/MM/DD/hh:mm:ss’  
               Note: if YYYY/MM/DD is missing date, defaults to first day in data set  
               timerange=’09:14:0~09:54:0’ picks 40 min on first day  
               timerange= ’25:00:00~27:30:00’ picks 1 hr to 3 hr 30min on next day  
               timerange=’09:44:00’ data within one integration of time  
               timerange=’>10:24:00’ data after this time  
        array  -- (Sub)array number range  
            default: ’’=all  
uvrange -- Select data within uvrange (default units meters)  
            default: ’’=all; example:  
            uvrange=’0~1000klambda’; uvrange from 0-1000 kilo-lambda  
            uvrange=’>4klambda’;uvranges greater than 4 kilo-lambda  
            uvrange=’0~1000km’; uvrange in kilometers  
scan -- Scan number range  
            default: ’’=all  
 

Please send any comments or questions about CASA or AIPS++ to aips2-requests@nrao.edu

Copyright © 2008 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

Updated daily during alpha development.