REMIP - Remove instrumental polarisation from SCUBA pol data

Description:

This task calculates and removes the instrumental polarisation signal from SCUBA polarimeter data.

For a fractional instrumental polarisation $P_I(e)$ at angle $\theta(e)$ and elevation $e$ (the instrumental polarisation is elevation dependent) the correction to the measured flux at waveplate angle $W$ is:

$$S_{Actual} = S_{Measured} - S_{Mean} P_I(e) ( 1 + \cos(4W - 2\theta(e)))$$ (1)

For SCUBA, we can not trivially measure the mean flux level (since each bolometer is jiggling to different areas on the sky) so this task uses an approximate form of the above equation to correct for instrumental polarisation that is valid for IPs of a few percent:

$$S_{Actual} \approx S_{Measured} * (1 - P_I(e) (1 + \cos(4W - 2\theta(e) ) ) )$$ (2)

where we have made the approximation that $S_{Mean} \approx S_{Measured}$.

Usage:

remip in ipfile out

Parameters:

IN = NDF (Read)

Input data file.

IPFILE = FILE (Read)

File containing the IP `flatfield'

MSG_FILTER = CHAR (Read)

Message filter level. Options are QUIET, NORMAL and VERBOSE. Default is NORM.

OUT = NDF (Write)

Output file containing IP removed data. Default output filename is `_ip' (`i' for short form).

Examples:

remip file1 ipfile.dat $\backslash$$\backslash$

Correct file1.sdf using ipfile.dat and write IP corrected data to the default output file (eg file1_ip).

Notes:

• Variance is propagated correctly.

• This task writes out the waveplate angles and rotation angles. The waveplate angle per integration is written to .MORE.REDS.WPLATE. The rotation angle (waveplate 0 to X pixel axis) is written to .MORE.REDS.ANGROT (angle per integration). The angle between nasmyth and the ra/dec frame (ie ANGROT - 90 degrees) is stored in .MORE.REDS.NASMYTH_ANG (angle per sample). These are written as NDFs and so can be displayed in the normal way. The angles are in degrees.

• An array containing the fast axis angle is also written to the REDS extension (FAST_AXIS). The size of this array matches the number of sub-instruments in the file.