Split: Difference between revisions

From CASA Guides
Jump to navigationJump to search
(Created page with '== Help on split task: == <pre> Create a visibility subset from an existing visibility set Split is the general purpose program to make a new data set that is a subs…')
 
(Replaced content with "{{split}}")
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
== Help on split task: ==
{{split}}
 
<pre>
Create a visibility subset from an existing visibility set
 
 
    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 to be a field index
              otherwise, it is assumed to be 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 - chans 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 to 63 for all IFs
                      ';' 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 4
        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 to be an antenna index
                otherwise, it is assumed to be 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, timerange defaults to the
              first day in the dataset
              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
</pre>

Latest revision as of 16:34, 18 May 2015