NAME

nuskytodet -- Calculates the DET1 and DET2 coordinates of a SKY pixel for NuSTAR

USAGE

nuskytodet pntra pntdec attfile instrument mastaspectfile skydetfile [parameter = < value >]

DESCRIPTION

'nuskytodet' calculates as a function of time the Focal Plane Bench Frame (DET1) coordinates and the Optics Bench Frame (DET2) coordinates of a pixel in the SKY frame.

'nuskytodet' reads the input SKY coordinates from the parameters 'skyxref' and 'skyyref'. The tranformations from SKY to DET1 and DET2 frames are calculated using information from the attitude file ('attfile'), the mast aspect solution file ('mastaspectfile') and the two CALDB files 'teldef' and 'align'. The DET1 and DET2 values as a function of time are stored in the output file 'skydetfile'.

PARAMETERS

pntra [real]
R.A. of S/C nominal pointing (degrees).

pntdec [real]
Declination of S/C nominal pointing (degrees).

attfile [filename]
Name of FITS attitude file.

(alignfile=CALDB) [filename]
Name of the input alignment file or CALDB.

(teldef=CALDB) [filename]
Name of teldef calibration file or CALDB.

instrument [string]
Focal Plane Module (FPMA or FPMB).

(aberration=no) [boolean]
If set to yes, aberration is included in aspecting.

skydetfile [filename]
Name of the output SKY Reference Pixel File in DET1 and DET2 system.

(skyxref = 500) [real]
Y coordinate of the SKY reference pixel.

(skyyref = 500) [real]
X coordinate of the SKY reference pixel.

mastaspectfile [filename]
Name of the input Mast Aspect Solution File.

(initseed=no) [boolean]
If set to yes, the random number generator uses a frozen seed value. If set to no, different seeds are generated for each run.

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

(history=yes) [boolean]
If set to yes, write parameter values and other information in HISTORY blocks.

(chatter = 2) [integer]
Chatter Level (min=0, max=5).

EXAMPLES

  1. Calculate the DET1 and DET2 coordinates of the SKY pixel (X,Y)=(500,500) and store them in the output file 'nu40060001001A_skydet.fits'. 

    >  nuskytodet mastaspectfile=nu40060001001_mast.fits attfile=nu40060001001_att.fits pntra=258.3 pntdec=-23.7
   skydetfile=nu40060001001A_skydet.fits

    BUGS

    SEE ALSO

    LAST MODIFIED

    October 2012