NuSTAR Data Analysis Software and Calibration history
The NuSTAR Data Analysis Software (NuSTARDAS) package has been jointly developed by the ASI Space Science Data Center (SSDC, Italy) and the California Institute of Technology (Caltech, USA). The first table presents a history of the NuSTARDAS public releases, click on the NuSTARDAS version number to obtain the associated release notes.
The release history of associated calibration database files (CALDB) is presented below.
The NuSTARDAS and CALDB releases can be obtained from the HEASARC:
HEASoft https://heasarc.gsfc.nasa.gov/docs/software/lheasoft/
NuSTARDAS https://heasarc.gsfc.nasa.gov/docs/nustar/analysis/
(Including the NuSTARDAS software users guide)
CALDB https://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/nustar/
HEASoft | https://heasarc.gsfc.nasa.gov/docs/software/lheasoft/ |
NuSTARDAS | https://heasarc.gsfc.nasa.gov/docs/nustar/analysis/
(Including the NuSTARDAS software users guide) |
CALDB | https://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/nustar/ |
Information on additional, user-contributed NuSTAR software for performing timing analysis, analysis of stray light sources, and background modeling, is available on the NuSTAR GitHub.
Last update: 2022-03-29
NuSTARDAS Releases | ||||
---|---|---|---|---|
Date | Release Version | Linked to CALDB | ||
HEAsoft | NuSTARDAS | |||
2022-03-14 | 6.30 | 2.1.2 |
nuproducts self documentation numkarf, numkrmf Added 'CALDBVER' keyword to output ARF and RMF files. | 20211020 (and later) |
2021-07-19 | 6.29 | 2.1.1 |
Disable default temperature dependant ARF (FPMA) (reverses default in v2.0.0) nupipeline Modified call of nuproducts (added arfmlicorr parameter) nuproducts Modified call of numkarf (added arfmlicorr parameter) numkarf No default Temperature dependency for ARF CALDB query, mlicorr default='no' Memory allocation increase (for large PID values) | 20210210 (and later) |
2020-08-14 | 6.28 | 2.0.0 |
Temperature dependent ARF numkarf Temperature dependency for ARF CALDB query, added obebhkfile input parameter nuproducts Modified call of numkarf (added obebhkfile parameter) nupipeline Modified call of nuproducts (added inobebhkfile and obebhkfile parameters) nu_highfits Modified to support TFORM values 1PD(X)/1PI(X) | 20200813 |
2020-04-13 | 6.27.1 | 1.9.2 1.9.1 |
numetrology upgrade to handle laser metrology METSTATE 4 and 6
Required for analysis of observations performed after 2020-03-16 | 20200429 |
2020-03-26 | 6.27 | 1.9.0 |
nupipeline set orbit file = attorb for barycorr=yes and exitstage=3
nuproducts new input parameter write_baryevtfile nuscreen added PRIOR column in default column list for cleaned event files | |
2019-05-17 | 6.26 | n/a | FTOOLS barycorr added support for NuSTAR 'fine' clock correction | |
2018-10-22 | 6.25 | n/a | Improved handling of remote CALDB and file i/o diagnostic output | |
2017-08-15 | 6.22 | 1.8.0 |
nucalcsaa added saacalc=3 mode, improve handling of input cleaned event files nuexpomap improvement in time-averaged optical axis location for vignetting corrected exposure map nuscreen supress warning messages for zero exposure time numkarf improvement to extended source efective area calculation nupipeline support handling of saacalc=3 mode | 20170727 |
2017-01-18 | 6.20 | 1.7.0 |
nucalcsaa no fselect run if saamode=NONE and tentacle=no
nupipeline select appropriate TLE file nuscreen bug fix nufilter add parameter timeadj=DEFAULT | |
2016-05-11 | 6.19 | 1.6.0 |
nusplitsc New task for mode 06 event data
nucalcsaa optimized SAA screening nupipeline accomode nusplitsc and nucaclsaa changes nuflagbad bug fix nuscreen add keyword OBSMODE nufilter add keywords MJDREF and MJDREFF in nu*.mkarf file nucoord update value of RA_NOM and DEC_NOM in unfiltered event files | 20160502 |
2015-07-29 | 6.17 | 1.5.1 |
numkarf new input parameters pilowarf, pihigharf and flatflag
numkrmf bug fix for addrmf execution nuproducts new input parameters to support numkarf changes nupipeline new input parameters to support numkarf changes, handle casses where cleaned event file is empty FTOOLS XSELECT updated entry for NuSTAR mkf name | |
2014-07-02 | 6.16 | 1.4.1 |
nuproducts automatically apply grppha, new inputparameter usrgtobarycorr
nupipeline addition of input parameter productsgtibarycorr | |
1.4.0 |
nuexpomap add parameter indet2instrfile, optimization of execution time
nubackscale add parameter inexpomapfile nulccorr add parameters inskyinstrfile inaspecthistofile numkarf add parameter inexpomapfile nuproducts add parameter rungrppha, modify calls to nubackscale, nulccorr, and numkarf nucalcpi modification of algorithm for GRADE 0 and GRADE 9-20 events nupipeline handling of compressed TLE files, support latest Perl versions | |||
2014-01-28 | 6.15.1 | 1.3.1 |
nuexpomap addition of keywords PIXBIN and PERCENT to header
nulccorr update value of DEADAPP to True nupipeline implement barycorr in call to nuproducts nuproducts implement barycorr, energy filtering through pilow and pihigh |
|
2013-11-25 | 6.15 | 1.3.0 |
numetrology psdcal input parameter
nuscreen NUPSDOUT keyword numkarf energy dependent PSF correction nuexpomap inclusion of bad/hot pixels in exposure maps nulccorr energy dependent PSF correction nupipeline psdcal input parameter |
|
2013-08-06 | 6.14 | 1.2.0 | NuSTARDAS Initial release
FTOOLS barycorr add NuSTAR CALDB query capability XSELECT added entries for NuSTAR to xselect.mdb | 20130509 |
2012-12-21 | 6.13 | n/a | FTOOLS aberrator update to support NuSTAR orbit extension barycorr update to support NuSTAR clock |
- • A flux increase of ~5% for sources < 1' off-axis
- □ A flux increase of ~10% for sources 1' to 2' off-axis
- □ A flux increase of ~15% for sources > 4' off-axis
- • Slopes of power law model components may change by ~0.04 depending on off-axis angle
- • More accurate high-energy and high off-axis angle corrections
- • A better agreement in the FPMA and FPMB flux measurements
- Defines how CHU combinations are split with nusplitsc
- requires NuSTARDAS v1.6.0 or later
- SAAPAR update
CALDB release history
This list does not include releases that are only for updates to clock correction files that occur approximatly every two weeks. Click on the version number for the release notes and click HERE for a combined ASCII file of all CALDB releases.
Release date | Version | Description |
---|---|---|
2022-05-10 | 20220510 |
This update adjusts the long-term gain calibration for FPMA DET2. This release is only for FPMA and only affects the gain calibration for DET2. This changes corrects a total 2% drop in the line energy calibration from 2015 to 2022 on this detector.
Details of the analysis can be found in the calibration memo (CAL_NuSTAR_20220510.pdf) available on the NuSTAR calibration webpage at the HEASARC: https://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/nustar/docs/fpm/index.html There is no update to NuSTARDAS required to utilize CALDB v20220510. This update includes Clock Correction file v139. |
2021-10-26 | 20211020 |
This CALDB release contains a major update in the calibration of the NuSTAR observatory based on detailed analysis of more than nine years of observations of the Crab, utilizing both focused and stray light measurements. Details of the analysis are presented in Madsen et al. (2021) JATIS, in prep. (arXiv), which is also available via the HEASARC CALDB documentation page.
A detailed summary of this update is also available on the CALDB 20211020 SOC webpage. The overall changes between the previous (CALDB v20211004 and earlier) and this new calibration are primarily off-axis dependent. Users of the updated calibration may see the following changes compared to previous analysis: We expect that for most NuSTAR observations this calibration update will have little or no practical change in interpretation results, especially for analysis of low signal-to-noise spectra. This CALDB release also contains an update to the tracking of the NuSTAR detector gain. Details are available in the calibration memo Grefenstette et al. (2021). There is no update to NuSTARDAS required to utilize CALDB v20211020. |
2021-02-23 | 20210210 | This CALDB release contains an update to NuSTAR alignment calibration to improve observatory astrometry bringing the source positions on both Focal Plane Modules into better agreement with one another and closer to the J2000 source coordinates. The update is in the CALDB only (no NuSTARDAS update required) and affects the source position of events only and not the energy of events.
This alignment update primarily improves observations taken after August 2017, but also adds some improvements across the entire mission lifetime. Before 2017, the astrometric improvement is on the order of a pixel (~2.5 arcsec). From 2017 onwards, the adjustment of the source coordinates steadily increases from one pixel in 2017 up to a possible 4-5 pixels (8 - 10 arcsec) in late 2020.
This release also contains an update to the NuSTAR Clock Correction file (v116) as well as a file describing the attenuation due to the beryllium (Be) window covering the detectors. This file is useful for some users performing analysis of stray light (either stray light due to the cosmic X-ray background or stray light due to off-axis, bright X-ray sources) but is not directly used by NuSTARDAS. |
2020-11-03 | 20201101 | This CALDB release contains an update to the NuSTAR Clock Correction file that corrects for previous gaps in NuSTAR instrument engineering files. Affected sequenceID's have been reprocessed and redelivered to the NuSTAR archive. A list of these sequenceID's can be found on the DLOG update webpage. The clock correction file in this release (v111) was produced based on the updated engineering files and is expected to provide improved performance than the previous clock file, especially for observations that occurred during the previous gaps. |
2020-08-13 | 20200813 | This CALDB update contains required files for the NuSTARDAS v2.0.0 update which implements a new temperature-dependence during the ARF generation. v108 (and later) Clock correction files contain an improvement of the clock offset model that corrects for a ~5ms systematic shift in absolute alignment to UTC time. Corrects for time intervals with no temperature measurements. |
2020-05-06 | 20200429 | High resolution clock correction files implemented MLI correction of ARF for FPMA |
2019-12-19 | 20191219 | Patch for release 20191213 which updated the gain and badpixel files |
2019-12-13 | 20191213 | Update for long term gain tracking and badpixel files |
2017-08-21 | 20170727 | CALDB files used for SAA filtering saamode=3 |
2016-06-06 | 20160606 | Update gain, effective area, line of sight absorption gain v007, DETABS v003, VIGN v007 |
2016-05-02 | 20160502 | |
2015-03-20 | 20150316 | Gain calibration improvement over the entire mission |
2014-07-01 | 20140414 | Adjusted CLC files to improve gain calibration |
2014-01-17 | 20131223 | VIGN adjustment (69.5 keV W edge) |
2013-11-25 | 20131007 | ARF adjustment to match XMM/Swift/Chandra fluxes (NuSTAR flux -15%) Updates to INSTRMAP, PIXPOS, energy dependent PSF Updated hkrange files |
2013-08-14 | 20130509 | Initial CALDB release |