NAME

ixpecalcstokes -- Calculate the Stokes parameters of IXPE event files

USAGE

ixpecalcstokes infile outfile [parameter = < value >]

DESCRIPTION

'ixpecalcstokes' calculates the Stokes parameters in detector coordinates (columns 'DETQ' and 'DETU') of IXPE event files. As a first step, the module adds the 'DETPHI', 'DETX' and 'DETY' columns to the ouput file. By default (input parameter 'applycut=no'), the values of these columns are set to those calculated in the 2nd pass of the moment analysis applied by the 'ixpeevtrecon' module: 'DETPHI=DETPHI2', 'DETX=ABSX' and 'DETY=ABSY'. As a second step, for each event the Stokes parameters in detector coordinates are calculated as follows: 'DETQ=2*cos(2*DETPHI)' and 'DETU=2*sin(2*DETPHI)'.

PARAMETERS

infile [file name]
Name of the input FITS Event File.

outfile [file name]
Name of the output FITS Event File.

(applycut=no) [boolean]
Apply cut for best angle and position estimation? (yes/no) (=yes only for debug)

(logFile=ixpecalcstokes.log) [file name]
Name of the Stokes parameters calculation log file.

(logTermLvl=1) [integer]
Log Terminal level (0=dbg, 1=info, 2=wrn, 3=error, 4=critical).

(logFileLvl=1) [integer]
Log File level (0=dbg, 1=info, 2=wrn, 3=error, 4=critical).

(clobber=no) [boolean]
If set to yes, overwrite the output file.

EXAMPLES

  1. Calculate the Stokes parameters in detector coordinates for the input event file 'ixpe00000000_det1_evt1_v01.fits'. The results are written in 'DETPHI', 'DETX', 'DETY', 'DETQ' and 'DETU' columns of the output event file 'ixpe00000000_det1_evt1_v01_out.fits'. 

     > ixpecalcstokes infile=ixpe00000000_det1_evt1_v01.fits outfile=ixpe00000000_det1_evt1_v01_out.fits

BUGS

SEE ALSO

LAST MODIFIED

February 2022