'nufilter' creates a filter file, containing all the housekeeping information, to be used in the data screening. This is achieved by running in sequence the multi-mission tasks 'prefilter' and 'makefilter'.
The first step is to derive attitude and orbit related quantities through the 'prefilter' task. The satellite attitude information included in the attitude file is interpolated and the NORAD two line elements (TLEs) are propagated to determine satellite ephemeris quantities. This information is used to calculate quantities such as Elevation Angle, Bright Earth Angle, Sun Angle, Cut off rigidity, etc. The output file of 'prefilter' (parameter 'attorbfile') contains a set of columns stored in the CALDB file 'preconfigfile'.
The housekeeping information is read from the input orbit file (parameter 'orbitfile'), the housekeeping files (parameters 'hkfile' and 'cebhkfile'), the Position Sensing Detector file (parameter 'psdcorfile'), the spacecraft attitude file (parameter 'attfile') and the 'prefilter' output file ('attorbfile').
The 'makefilter' configuration file, provided in input through the parameter 'mkfconfigfile', is a FITS file (by default read from the CALDB) which contains for each parameter requested the following information: the parameter name, the name of the FITS file, the name of the extension containing the parameter, the interpolation method, the calibration method, the output parameter name and comments for the corresponding keyword in the output filter file. The interpolation method is used when the value of a specific parameter is not present at given times; the calibration method is applied when some simple numerical manipulations on the input HK parameters is needed. Currently, the default of the interpolation method is set to copy the last known value of that parameter. The calibration method has not been implemented yet. See also the 'makefilter' help file for further details.
> nufilter hkfile=nu40060001001A_fpm.hk attfile=nu40060001001_att.fits orbitfile=nu40060001001_orb.fits cebhkfile=nu40060001001A_ceb.hk psdcorfile=nu40060001001_psdcorr.fits outdir=./outdir tlefile=NUSTAR_TLE_ARCHIVE.txt pntra=258.3 pntdec=-23.7