NAME

numetrology -- Process the metrology data for NuSTAR

USAGE

numetrology metrologyfile [parameter = < value >]

DESCRIPTION

The task calculates the laser positions on the two PSD detectors, tracking the spacecraft mast movements, by processing the input telemetry metrology raw data (parameter 'metrologyfile'). The PSD X/Y coordinates are written in the output file 'outpsdfile'. If the input parameter 'psdflag' is set to 'yes' (default value), the X/Y coordinates are corrected for the PSD detector distorsions using the information stored in the CALDB Metrology Grid file (parameter 'metgridfile') and written in the outputfile 'outpsdfilecor'. By setting 'psdcal=no', the X/Y coordinates are not corrected and the original values are copied into the outputfile 'outpsdfilecor'. Finally, the PSD lasers positions stored in the outputfile 'outpsdfilecor' are used to calculate the mast aspect solution which is written in the output file 'mastaspectfile'.

By default the task processes the raw metrology data (parameter 'metflag=yes'). By setting the 'metflag' parameter to 'no', the corrected Position Sensing Detector File must be provided in input through the parameter 'inpsdfilecor'.

PARAMETERS

(metflag=yes) [boolean]
If set to yes, the task processes the metrology data.

metrologyfile [file name]
Name of the input raw Metrology File (used only if parameter 'metflag' is set to 'yes').

(metgridfile=CALDB) [file name]
Name of the input Metrology Grid File or CALDB (used only if parameter 'metflag' is set to 'yes').

inpsdfilecor [filename]
Name of the input corrected Position Sensing Detector File (used only if metflag=no).

(outpsdfile=DEFAULT) [filename]
Name of the output Position Sensing Detector File or DEFAULT to use standard name (used only if parameter 'metflag' is set to 'yes').

(outpsdfilecor=DEFAULT) [filename]
Name of the output corrected Position Sensing Detector File or DEFAULT to use standard name (used only if parameter 'metflag' is set to 'yes').

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

(mastaspectfile=DEFAULT) [filename]
Name of the output Mast Aspect Solution File or DEFAULT to use standard name.

(psdcal=yes) [boolean]
If set to yes, the task apply PSD linearization to the corrected Position Sensing Detector File.

(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. Process the metrology data file 'nu40060001001_met.fits' using the calibration information stored in the CALDB. The mast aspect solution file is written in the output file 'nu40060001001_mast.fits'. The X/Y coordinates of the PSD detectors, before and after the correction for the distorsions, are stored in the output files 'nu40060001001_psd.fits' and 'nu40060001001_psdcorr.fits', respectively. 

    > numetrology metrologyfile=nu40060001001_met.fits

  2. Process the corrected Position Sensing Detector File 'nu40060001001_psdcorr.fits' and generate the mast aspect solution file 'nu40060001001_mast.fits'. 

    > numetrology metflag=no inpsdfilecor=nu40060001001_psdcorr.fits mastaspecfile=nu40060001001_mast.fits

    BUGS

    SEE ALSO

    LAST MODIFIED

    October 2016