Getting Started Documentation Glish Learn More Programming Contact Us
Version 1.9 Build 1488
News FAQ
Search Home


next up previous contents index
Next: imagepol.sigmafraclinpol - Function Up: imagepol - Tool Previous: imagepol.sigma - Function


imagepol.sigmadepolratio - Function



Package general
Module images
Tool imagepol


Error in linear depolarization ratio


Synopsis
sigmadepolratio(infile, debias, clip, sigma, outfile)


Arguments

infile in Other image
    Allowed: String or Image tool
debias in Debias the linearly polarized intensity ?
    Allowed: T or F
    Default: F
clip in Clip level for auto-sigma determination
    Allowed: Float
    Default: 10
sigma in Standard deviation of thermal noise
    Allowed: Float
    Default: Auto determined
outfile in Output image file name
    Allowed: String
    Default: Unset


Returns
Image tool or fail



Description

This function (short-hand name edr) returns the error in the linear depolarization ratio computed from two frequencies; this is the ratio of the fractional linear polarization at the two frequencies. Generally this is done when you have generated two images, each at a different frequency (continuum work). Thus if the fractional linear polarzation images are m1 and m2 then the depolarization ratio is m1/m2.

This function operates with two images; the first is that with which you constructed your Imagepol tool. The second is supplied via the argument infile, which can be an Image tool, or a String holding the name of the image file.

In generating the depolarization ratio, and hence its error, you may optionally debias the linearly polarized intensity. This requires the standard deviation of the thermal noise. You can either supply it if you know it, or it will be worked out for you with outliers from the mean clipped at the specified level.

You can get the depolarization ratio image with function depolratio.



Example
- im1 := image('stokes.4800')
- im2 := image('stokes.8300')
- p := imagepol(im1)
- dpr := p.depolratio(im2);
- edpr := p.sigmadepolratio(im2);





next up previous contents index
Next: imagepol.sigmafraclinpol - Function Up: imagepol - Tool Previous: imagepol.sigma - Function   Contents   Index
Please send questions or comments about AIPS++ to aips2-request@nrao.edu.
Copyright © 1995-2000 Associated Universities Inc., Washington, D.C.

Return to AIPS++ Home Page
2006-08-01