(Note: This assumes you have already set your HEADAS environment variables with the
headas-init script, as you would if you were running XSPEC.)
To make sure your XSPEC installation is up to date with ALL listed patches:
1.    If you don't already have the patch installer
tcl script (v4.8), download and place it in the XSPEC src directory. This directory
should be at heasoft-[ver]/Xspec/src from the source code distribution.
2.    Download the latest patchfile into
the same directory. There is no need to unzip/untar the patchfile
since the installer will do that.
3.    At the command line, launch the script by typing
'tclsh patch_install_[ver].tcl',
and that's all.
The script should detect which patches you've installed previously, copy
the new code files to the necessary directories, determine whether complete or only partial
rebuilds are necessary, and finally perform the rebuilds. Numbers listed in red indicate that the patch modifies the interface
to one or more of XSPEC's libraries. These patches will generally cause longer rebuilds. If you
have a local model library, it is recommended (though not always necessary) that you rebuild it
with initpackage after applying red patches.
12.9.1a |
This improves XSPEC's default Y-axis plot range display for log plots when
there are ignored channels. It also expands the maximum default range. Our thanks
to Kim Page for bringing this to our attention.
Report added on Feb 13, 2017.
This patch modifies heasoft-6.20/Xspec/src/XSPlot/Commands/
PlotData.cxx,
PlotFoldmodel.cxx, XSPlot/Plot/
PlotGroup.cxx,
PlotVector.cxx and
.h
|
12.9.1b |
The default behavior of goodness has now been changed to drawing
parameter values from the posterior distribution (sim instead of
nosim) and fitting the simulated data before calculating the test
statistic value (fit instead of nofit). Our thanks to Vinay Kashyap,
Yang Chen, and Xufei Wang of the CHASC astro-statistics collaboration
for helpful discussions on this.
Report added on Apr 11, 2017.
This patch modifies heasoft-6.20/Xspec/src/XSUser/Handler/
xsGoodness.cxx
|
12.9.1c |
A fix and an enhancement for tclout: The command
tclout(r) filename has been fixed for the case of type II pha files.
The file name was not being written with the {n} suffix used by the
data command to determine which row of the file to read.
Also a new tclout margin fractions option has been added to retrieve the
fractions column of the margin command output. Our thanks to Vikas Chand and
Thanassis Akylas for bringing these issues to our attention.
Report added on Apr 25, 2017.
This patch modifies heasoft-6.20/Xspec/src/XSUser/Handler/
xsTclout.cxx
|
12.9.1d |
In PyXspec, the Xset.parallel object now has additional attributes
steppar, walkers, and goodness, to match the options available in standard
XSPEC's parallel command. This also adds a new Xset.parallel.show()
function for displaying all current values. Our thanks to Shinya Nakashima for
bringing this to our attention.
Report added on Apr 25, 2017.
This patch modifies heasoft-6.20/Xspec/src/XSUser/Python/xspec/
xset.py
|
12.9.1e |
In PyXspec, the Xset.restore() function is not handling cd
commands. These commands may be inserted into Xset.save() output scripts when
data is loaded from multiple directories during a session.
Our thanks to Shinya Nakashima for bringing this to our attention.
Report added on May 03, 2017.
This patch modifies heasoft-6.20/Xspec/src/XSUser/Python/xspec/
xset.py
|
12.9.1f |
When running the error command while soft and hard limits
differ, the diagnostic output for "last attempt" misleadlingly reports the value
before readjustment when the attempt falls between the soft and hard limits. Our
thanks to Shinya Nakashima for bringing this to our attention.
Report added on June 02, 2017.
This patch modifies heasoft-6.21/Xspec/src/XSFit/Fit/
FitErrorCalc.cxx
|
12.9.1g |
When NEI_VERSION is not found in the Xspec.init file (or
is commented out), XSPEC is erroneously resetting the ATOMDB version
rather than the NEI version with the default string of "3.0.4".
Our thanks to Glenn Morris for bringing this to our attention.
Report added on June 02, 2017.
This patch modifies heasoft-6.21/Xspec/src/XSUser/Global/
Global.cxx
|
12.9.1h |
The goodness command is unable to perform in 'fit' mode when cstat (or
its variants) is in use. The parameters immediately freeze up on the first
iteration of the fitting attempt. Our thanks to Shinya Nakashima for bringing
this to our attention.
Report added on June 02, 2017.
This patch modifies heasoft-6.21/Xspec/src/XSFit/Fit/
Fit.cxx
|
12.9.1i |
Performing multiple XSPEC log file open and close operations can eventually lead to an
"unable to open file" error on Mac platforms. Our thanks to Paolo Tozzi for pointing this out.
Report added on June 16, 2017.
This patch modifies heasoft-6.21/Xspec/src/XSUser/UserInterface/
TclStream.cxx
|
12.9.1j |
This fixes several issues involving the goodness command. When running goodness
with multiple spectra, XSPEC's internal chatter level is not properly reset. This
prevents output from being displayed in later commands. When running goodness in
nosim fit mode, XSPEC should reset the fit covariance matrix back to its original
values rather than retain the values from the last simulation. And when running
in sim fit mode, it ought to reset the covariance after EVERY simulation.
This also fixes a flaw when running goodness in parallel processing
mode: the randomization within each process was starting from same initial seed, causing
the same random values to be generated. Our thanks to Piyush Sharda and Terry Gaetz
for helping out with these issues.
Report added on June 30, 2017.
This patch modifies heasoft-6.21/Xspec/src/XSFit/Fit/
Fit.cxx and src/XSUtil/Utils/
ProcessManager.cxx.
|
12.9.1k |
This improves the diagnostic output which gets displayed when XSPEC
can't find the eigenvector data files when running the nei model or its variants.
Report added on June 30, 2017.
This patch modifies heasoft-6.21/Xspec/src/XSFunctions/
IonBalNei.cxx
|
12.9.1l |
The approximation used for the Voigt line model does not work well for the case
of the Gaussian width much larger than the Lorentzian width. This patch replaces
the approximation with a true convolution to remove the problem at the cost of speed.
Our thanks to Shutaro Ueda and Yuto Ichinohe for bringing this to our attention.
Report added on July 26, 2017.
This patch modifies heasoft-6.21/Xspec/src/XSFunctions/
voigtLine.cxx
|
12.9.1m |
In the new Heasoft-6.22 release, the Tcl library XSPEC uses has been upgraded
from version 8.5 to 8.6. These modifications were necessary to make XSPEC
compatible with Tcl 8.6. For those still using XSPEC from the Heasoft-6.21 distribution,
these changes should have no effect.
Report added on Aug 18, 2017.
This patch modifies heasoft-6.21/Xspec/src/XSUser/Handler/
HandlerUtils.cxx, XSUser/UserInterface/
echcom.cxx,
TclRegEx.cxx,
TclStream.cxx, XSUtil/Signals/
SignalHandler.cxx
|
12.9.1n |
There is a factor of 2 normalization error in the calculation of the lorentzian
line in the "speedy" option. This isn't actually used anywhere in xspec at present
but might be a problem for external programs calling xspec code. Our thanks to Jeremy Sanders for providing this correction.
Report added on Aug 18, 2017.
This patch modifies heasoft-6.21/Xspec/src/XSFunctions/
calcLines.cxx
|
12.9.1o |
Fix for a multiple-prompting error in certain cases of missing data files.
Our thanks to Ed Sabol for pointing this out.
Report added on Oct 10, 2017.
This patch modifies heasoft-6.22/Xspec/src/XSUtils/Parse/
XSparse.cxx and XSUtils/Utils/
XSstream.cxx
|
12.9.1p |
When steppar is run in parallel mode AND the number of
processes exceeds the number of steps, multiple unnecessary error messages
are issued which may also appear mangled. Our thanks to Jeremy Sanders for
pointing this out.
Report added on Oct 10, 2017.
This patch modifies heasoft-6.22/Xspec/src/XSFit/Fit/
Step.cxx
|
12.9.1q |
This improves XSPEC's plotting behavior when dealing with data sets
or models with zero Y-axis range. Our thanks to Brian Grefenstette for bringing this
to our attention.
Report added on Nov 08, 2017.
This patch modifies heasoft-6.22/Xspec/src/XSPlot/Commands/
PlotData.cxx,
PlotModel.cxx, XSPlot/Plot/
PlotGroup.cxx,
PlotGroupCreator.cxx and
PlotVector.cxx
|
12.9.1r |
The mekal and vmekal models do not work with the switch
parameter set to 2. Our thanks to Koji Mukai and Raimundo Lopes for reporting this error.
Report added on Nov 30, 2017.
This patch modifies heasoft-6.22/Xspec/src/XSFunctions/
vmekal.cxx
|
12.9.1s |
For PyXspec, this adds a new class member Fit.nullhyp. This provides
access to the null hypothesis probability reported after chi-square fits, equivalent
to tclout nullhyp in standard Xspec. Our thanks to Renato Martone for bringing this to our attention.
Report added on Nov 30, 2017.
This patch modifies heasoft-6.22/Xspec/src/XSUser/Python/xspec/
fit.py
|
12.9.1t |
Changing solar abundance table from the default (angr) does not work correctly for the
raymond, meka, or mekal models. The apec models (which should be used) work correctly.
This bug was introduced in v12.9.0. Our thanks to Shinya Nakashima for reporting it.
Report added on Dec 13, 2017.
This patch modifies heasoft-6.22/Xspec/src/XSFunctions/
calcMultiTempPlasma.cxx
|
12.9.1u |
For PyXspec, this adds proper handling of gain fit parameters
when stored and read back in with Xset.save and Xset.restore. Our thanks
to Yoshiaki Kanemaru for bringing this to our attention.
Report added on Dec 27, 2017.
This patch modifies heasoft-6.22/Xspec/src/XSUser/Python/xspec/
xset.py
|