NRAO Home > CASA > CASA Task Reference Manual

0.1.135 uvcontsub3

Requires:

Synopsis
An experimental clone of uvcontsub

Description



Arguments





Inputs

vis

Name of input MS. Output goes to vis + ”.contsub”

allowed:

string

Default:

fitspw

Spectral window:channel selection for fitting the continuum

allowed:

string

Default:

combine

Data axes to combine for the continuum estimation (none (”) or spw)

allowed:

string

Default:

fitorder

Polynomial order for the fits

allowed:

int

Default:

0

field

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

allowed:

any

Default:

variant

spw

Spectral window selection for output

allowed:

string

Default:

scan

Select data by scan numbers

allowed:

string

Default:

intent

Select data by scan intents

allowed:

string

Default:

correlation

Select correlations

allowed:

any

Default:

variant

observation

Select by observation ID(s)

allowed:

any

Default:

variant

Example

 
 
uvcontsub3 is an experimental clone of uvcontsub with the goal of taking  
        less time and temporary disk space.  
 
Continuum fitting and subtraction in the uv plane:  
 
This task estimates the continuum emission by fitting polynomials to  
        the real and imaginary parts of the spectral windows and channels  
        selected by fitspw.  This fit represents a model of the continuum in  
        all channels.  
 
        The fitted continuum spectrum is subtracted from all channels  
        selected in spw, and the result (presumably only line emission)  
        is stored in a new MS (vis + ".contsub").  
It will read from the CORRECTED_DATA column of vis if it is present,  
or DATA if it is not.  Whichever column is read is presumed to have  
already been calibrated.  
 
        Keyword arguments:  
        vis -- Name of input visibility file  
                default: none; example: vis=’ngc5921.ms’  
 
fitspw -- Selection of spectral windows and channels to use in the  
          fit for the continuum, using general spw:chan syntax.  
          See the note under combine.  
default: ’’ (all)  
                example: fitspw=’0:5~30;40~55’  
 
        combine -- Let the continuum estimation span multiple spectral windows.  
                   default = ’’ (Make separate estimates for each spw.)  
                   combine = ’spw’: Necessary when one or more of the spws are  
                                    completely blanketed by lines, so the estimate  
                                    must be made in different spws.  
 
fitorder -- Polynomial order for the fits of the continuum w.r.t.  
                    frequency.  fitorders > 1 are strongly discouraged  
                    because high order polynomials have more flexibility, may  
                    absorb line emission, and tend go wild at the edges of  
                    fitspw, which is not what you want.  
 
default: 0 (constant); example: fitorder=1  
 
        field -- Field selection for continuum estimation and subtraction.  
                 The estimation and subtraction is done for each selected field  
                 in turn.  (Run listobs to get lists of the ID and names.)  
               default: ’’=all fields.  If the 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’; fields named 3C286 and 3C295  
               field = ’3,4C*’; field id 3, all names starting with 4C  
 
        spw -- Select spectral windows for the output.  
               default: ’’=all spectral windows  
               N.B. uvcontsub3 does not yet support exclusion by channels for  
                    the output.  Meanwhile, use split to further reduce the size  
                    of the output MS if desired.  
               spw=’0~2,4’; spectral windows 0,1,2,4  
               spw=’<2’;  spectral windows less than 2 (i.e. 0,1)  
 
scan -- Scan number range  
            default: ’’=all  
 
        intent -- Select by scan intent (state).  Case sensitive.  
            default: ’’ = all  
            Examples:  
            intent = ’CALIBRATE_ATMOSPHERE_REFERENCE’  
            intent = ’calibrate_atmosphere_reference’.upper() # same as above  
            # Select states that include one or both of CALIBRATE_WVR.REFERENCE  
            # or OBSERVE_TARGET_ON_SOURCE.  
            intent = ’CALIBRATE_WVR.REFERENCE, OBSERVE_TARGET_ON_SOURCE’  
 
        correlation -- Select correlations, e.g. ’rr, ll’ or [’XY’, ’YX’].  
                       default ’’ (all).  
 
        observation -- Select by observation ID(s).  
                       default: ’’ = all  
 


More information about CASA may be found at the CASA web page

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