********************************************************************************
                                    NUSTAR
********************************************************************************

NuSTARDAS version 1.3.0:

Major changes introduced in this version:

- numetrology: Addition of the new input parameter psdcal, with default value yes, to optionally (if set to no) disable the linearization of the PSD X/Y coordinates.

- nuscreen: for SCIENCE observing mode
  1) introduction of a new run of the FTOOL maketime to calculate the ONTIME value during which the PSD coordinates are outside the CALDB metgridfile calibrated grid and
  2) addition of a new keyword named NUPSDOUT to the output event file storing the ONTIME calculated value. See the NuSTARDAS users guide sections 4.5 and 6.3.

- numkarf:
  0) for extended sources (parameter extended=yes) the input parameters grflag and psfflag are automatically set to no;
  1) introduction of an energy dependent PSF correction;
  2) fixed bug for small values of the input parameter boxsize (extended source case);
  3) changed the call to the nuexpomap module.

- nuexpomap: introduction of a new algorithm for inclusion of bad/hot pixels in exposure maps.

- nulccorr:
  1) correction for PSF losses using a CALDB PSF file corresponding to the value of the energy input parameter;
  2) changed the call to the nuexpomap module.

- nubackscale: changed the call to the nuexpomap module;

- nupipeline:
  1) addition of the new input parameter psdcal;
  2) modified the call to the module numetrology;
  3) addition of the ONTIME value during which the PSD coordinates are outside the CALDB metgridfile in the STDOUT final report; modified call to modules nuexpomap and nuproducts to accomodate above changes.

- nuproducts: modified the call to the modules nulccorr, numkarf and nubackscale.

Summary of changes:

numetrology:

Allows the pipeline to be run with the calibration of the PSDs off. This prevents data from time periods when the PSDs are out-of-range from being lost in the cleaned event data (for some observations this may be result in as much as a 10-20% increase in exposure). The effect on the event reconstruction varies source-by-source, but the reconstruction will in general, be worse with the calibration turned off. Turning off the PSD calibration may also affect the absolute position reconstruction.

nuscreen:

In the default setting the pipeline now appends a keyword to the cleaned event files, "NUPSDOUT", that contains the number of seconds lost to the PSD out-of-range filter. If this is a large fraction of the total observation, then the user may want to turn off the PDS calibration and re-run the pipeline. See the NuSTARDAS users guide section 6.3.

numkarf:

(0) Fixed a bug where the ghost-ray and PSF corrections defaulted to "ON" even for extended sources. These flags correctly default to "OFF" when extended=YES.

(1) Includes the effect of the energy-dependent PSF when psfflag=YES. This effect is on the ~5% and primarily acts below 10 keV for sources extracted using small (<<30 arcsecond radius) extraction regions.

(2) Bug fix.

(3) Keyword maintenance.

nuexpomap:

Improved the algorithm for recomputing exposure maps. Pixels that are disabled (either in software on by the user via the userbadpix file) are now properly vetoed in the exposure map.

nulccorr:

Applies energy-dependent PSF corrections as per numkarf.