imcontsub

imcontsub(imagename, linefile='', contfile='', fitorder=0, region='', box='', chans='', stokes='')[source]

Estimates and subtracts continuum emission from an image cube

[Description] [Examples] [Development] [Details]

Parameters
  • imagename (string) - Name of the input spectral line image

  • linefile (string=’’) - Output continuum-subtracted image file name

  • contfile (string=’’) - Output continuum image file name

  • fitorder (int=0) - Polynomial order for the continuum estimation

  • region (string=’’) - Region selection.

  • box ({string, intArray, stringArray}=’’) - Rectangular region to select in direction plane. Default is to use the entire direction plane.

  • chans (string=’’) - Channels to use.

  • stokes (string=’’) - Stokes planes to use.

Description

imcontsub task: Estimates and subtracts continuum emission from an image cube

For each direction pixel in an image (or a subset selected by region and/or box), this task estimates the continuum by fitting a polynomial to one or more subsets of the channels. In most cases, the user should choose the subset(s) of channels to be free of spectral lines. The continuum estimate is saved in contfile and subtracted from the image (or its subset) to make a spectral line estimate, which is saved in linefile.

While imcontsub offers users the option to save the continuum estimate as a (multi-channel) dataset, the optimal way to create a continuum image is by using the multi-frequency synthesis (MFS) option in tclean.

Note that fitting the continuum and subtracting it from a spectral line data set can also be done in the (u,v)-domain using the task uvcontsub.

Task-specific Parameter Descriptions

linefile

Name of image to which to save the result of subtracting the computed continuum from the input image.

contfile

The computed continuum image.

fitorder

Order of polynomial to fit to the specified spectral channels to determine the continuum.

chans

Spectral channels to use for fitting a polynomial to determine continuum.

Examples

Fit a second order polynomial (fitorder=2) to channels 3-8 and 54-60 to an RA x Dec x Frequency x Stokes cube, selecting the Stokes I plane

ch = '3~8, 54~60'
imcontsub(imagename="myimage.im", linefile="mycontsub.im",
          fitorder=2, chans=ch, fitorder=2, stokes="I")
Development

No additional development details

Parameter Details

Detailed descriptions of each function parameter

imagename (string) - Input image cube.
Default: none
Example: imagename=’ngc5921_task.im’
linefile (string='') - Name of continuum-subtracted output spectral line cube
Default: none
Example: outline=’ngc5921_line.im’
contfile (string='') - Name of output continuum cube
Default: none
Example: contfile=’ngc5921_cont.im’
fitorder (int=0) - Polynomial order for the continuum estimation
Default: 0
Example: fitorder=2
region (string='') - Region selection.
Default: ‘’ (use the full image)
box ({string, intArray, stringArray}='') - Rectangular region to select in direction plane.
Default: ‘’ (use the entire direction plane)
chans (string='') - Channels to use.
Default: ‘’ (use all channels)
stokes (string='') - Stokes planes to use.
Default: ‘’ (use all Stokes planes)