NAME

nucoord -- Convert Raw coordinates into Detector and Sky coordinates of NuSTAR event files

USAGE

nucoord infile outfile mastaspectfile attfile pntra pntdec optaxisfile det1reffile [parameter = < value >]

DESCRIPTION

'nuccord' is a script that runs the modules necessary for the conversion of Raw coordinates into Detector and Sky coordinates of NuSTAR event files. The script also calculates the SKY position of the telescope optical axis and of a reference point in the DET1 frame.

First, the script runs the 'nucalcpos' task to calculate the detector coordinates in the Focal Plane Bench Frame ('DET1') and in the Optics Bench Frame ('DET2'). The details of this calculation can be found in the 'nucalcpos' help file.

Second, the 'nucoord' script runs the multi-mission ftool 'coordinator' to convert 'DET2' coordinates in SKY coordinates (see 'coordinator' help file).

Third, the 'nucoord' script runs the 'nuskypos' task for the generation of the optical axis file ('optaxisfile') and of the DET1 reference file ('det1reffile'). See the help file of the 'nuskypos' task for a more detailed description.

PARAMETERS

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

outfile [file name]
Name of output FITS Event 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.

(pixposfile=CALDB) [filename]
Name of the input pixel location file or CALDB.

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

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

attfile [filename]
Name of FITS attitude file.

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

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

(follow_sun=yes) [boolean]
If set to yes, recalculate the Sun position for each event.

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

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

(randomizecoordinator=yes) [boolean]
If set to yes, Randomize coordinates when rebinning.

(seedcoordinator=-1956) [integer]
Random number generator seed for coordinator task.

(timemargin=32) [real]
Allowed margin for time extrapolation (sec).

(attinterpol = LINEAR) [string]
Method to calculate attitude interpolation ([LINEAR|CONSTANT]).

optaxisfile [filename]
Name of the the output Optical Axis File.

det1reffile [filename]
Name of the the output DET1 Reference Pixel File.

(det1xref = 350) [integer]
DET1X coordinate of the detector reference pixel.

(det1yref = 350) [integer]
DET1Y coordinate of the detector reference pixel.

(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. Convert the RAW coordinates of the input event file 'nu40060001001A_uf.evt' to DET1, DET2 and SKY coordinates using the the pixel location file stored in the CALDB. The DET1X/DET1Y, DET2X/DET2Y and X/Y coordinates are written in the output file 'nu40060001001A_out.evt'. The optical axis file and the DET1 reference file are also generated. 

    >  nucoord infile=nu40060001001A_uf.evt outfile=nu40060001001A_out.evt mastaspectfile=nu40060001001_mast.fits
   attfile=nu40060001001_att.fits pntra=258.3 pntdec=-23.7 optaxisfile=nu40060001001A_oa.fits 
   det1reffile=nu40060001001A_det1.fits

    BUGS

    SEE ALSO

    LAST MODIFIED

    September 2012