skip to content
 
HEASARC: Software

 
Known issues and patches
Home Downloads Manual Issues/Patches Additional Models Xspec v11
    (updated 02/27/09) (updated 05/08/09)    

New issues from Xspec 12.5.0

For those linking the XSPEC models library into their own programs, the XSFunctions library now has new dependencies on libXSModel and libCCfits, requiring that they be linked into your program. See manual Appendix F for more details.

We recommend avoiding the X11 2.3.1 upgrade on the Mac OS X Intel platform, as it prevents PGPLOT's /xserve driver from properly refreshing the plot window. This problem has been fixed in the X11 2.3.2 release candidate versions. Our thanks to Terry Gaetz for pointing this out.

Frequently Asked Questions

List of currently outstanding issues.


Patches:

HEASOFT 6.6.2 is distributed with XSPEC12 already patched to version 12.5.0ac.

latest update 12.5.0ag May 08, 2009

Requires patch installer v2.5 or newer

To apply patches, you'll need to have downloaded and already built the source code distribution of XSPEC. For details about the patch installer including new options available with the latest v3.0, click here. Otherwise, just follow the instructions below.


(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 (v2.5 or later), 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.5.0a Bug fix to the kerrbb model for the (unlikely) case where only one of self-irradiation and limb-darkening is turned on. Our thanks to Li Xin-Li for pointing this out. Report added on Dec 01, 2008.

This patch modifies heasoft-6.6/Xspec/src/XSFunctions/ runkbb.f

12.5.0b When the editing commands addcomp, delcomp, or editmod have been used on a model that already contains linked parameters, the link expressions are not properly updated in the output to a save model file. Our thanks to Laura Brenneman for pointing this out. Report added on Dec 03, 2008.

This patch modifies heasoft-6.6/Xspec/src/XSUtil/Parse/ LinkExpression.cxx, src/XSModel/Model/ Model.cxx, and src/XSModel/Parameter/ ParameterLink.cxx

12.5.0c This removes the warnings issued if datasets contain CHANTYPE strings other than PI or PHA. It will still issue warnings if the CHANTYPE differs between the spectral data and RMF files. Report added on Dec 03, 2008.

This patch modifies heasoft-6.6/Xspec/src/main/ xsTypes.h, src/XSModel/Data/ OGIP-92aData.cxx, SpectralData.cxx, .h, src/XSModel/Data/BackCorr/ OGIP-92aBackground.cxx, src/XSModel/Data/Detector/ MultiResponse.cxx, RealResponse.cxx, and heasoft-6.6/Xspec/Integral/ SPI_Data.cxx

12.5.0d Additional C/Fortran function wrappers provided for the following recently added C++ models: cflux, partcov, simpl, and spexpcut. These are required for users who link the XSPEC models library into an external Fortran or C program. Our thanks to John Houck for pointing this out. Report added on Dec 03, 2008.

This patch modifies heasoft-6.6/Xspec/src/XSFunctions/ funcWrappers.cxx .h

12.5.0e In the FNINIT function (for users linking the XSPEC models library into their own programs), the default model data directory name needs to be updated from "modelIonData" to "modelData" to coincide with v12.5.0 restructuring. Our thanks to John Houck for pointing this out. Report added on Dec 05, 2008.

This patch modifies heasoft-6.6/Xspec/src/XSUtil/FunctionUtils/ xsFortran.cxx

12.5.0f Patch to improve the behavior of an exceptional case of Levenberg-Marquardt fitting, where a parameter becomes pegged due to a zero second-derivative matrix diagonal element AND the user chooses to exit before convergence. This prevents an attempt at a covariance calculation on the parameter, which otherwise might lead to a segmentation fault. Our thanks to Stefano Bianchi and Jeremy Sanders for pointing this out. Report added on Dec 05, 2008.

This patch modifies heasoft-6.6/Xspec/src/XSFit/FitMethod/LevMarq/ LevMarq.cxx

12.5.0g Fix to the swind1 model function. Now that it is included as part of XSPEC's built-in models library, it should no longer look to the $LMODDIR symbol for finding the model data directory. Our thanks to Delphine Porquet for pointing this out. Report added on Dec 09, 2008.

This patch modifies heasoft-6.6/Xspec/src/XSFunctions/ swind1.f

12.5.0h When doing a 2-panel plot of plot counts/lcounts chisq and the current fit statistic is cstat, the Y-axis scaling of the chisq panel is wrong. Our thanks to Fill Humphrey for pointing this out. Report added on Dec 09, 2008.

This patch modifies heasoft-6.6/Xspec/src/XSPlot/Commands/ PlotChiSq.cxx and PlotData2Panel.cxx

12.5.0i The energies extend option does not work properly for the case of a data group containing multiple responses whose energy bins differ. Our thanks to Joel Frioriksson for pointing this out. Report added on Dec 15, 2008.

This patch modifies heasoft-6.6/Xspec/src/XSModel/Model/ ModelBase.cxx

12.5.0j Parameter links both to and from a model which is not associated with any spectra (shown as "Active/Off" in the model display), should not be removed when the model's state gets updated (such as when using the dummyrsp command). Our thanks to Laura Brenneman for pointing this out. Report added on Dec 24, 2008.

This patch modifies heasoft-6.6/Xspec/src/XSModel/GlobalContainer/ ModelContainer.cxx

12.5.0k The dummyrsp command may cause a crash when entering a very large number of energy bins. Our thanks to Joel Frioriksson for pointing this out. Report added on Dec 31, 2008.

This patch modifies heasoft-6.6/Xspec/src/XSUtil/FunctionUtils/ XSCCall.cxx and XSF77.cxx

12.5.0l This slightly modifies the state of newly untied parameters. When a parameter is untied, its frozen/unfrozen setting should retain the setting of the parameter(s) to which it was linked, rather than be restored to its original value. Our thanks to Phil Evans and Delphine Porquet for pointing this out. Report added on Jan 14, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSModel/Parameter/ ModParam.cxx

12.5.0m When steppar is executed, it should not automatically run a fit at the end to place the parameters in their best-fit state. Instead it should restore the parameters to their pre-steppar values, regardless of the fit state. Our thanks to Tim Kallman for pointing this out. Report added on Jan 14, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSFit/Fit/ Step.cxx

12.5.0n Bug fix for a C-to-Fortran boolean conversion error, affecting the default setting for the thermal broadening flag of the bapec and bvapecmodels. Unless overridden by the APECTHERMAL setting, thermal broadening should be ON by default for bapec and bvapec. This bug has only been observed on Solaris platforms. Report added on Jan 15, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSFuntions/ sumdem.cxx, cemVMekal.cxx, and src/XSModel/Model/MixFunction/ xsmaug.cxx

12.5.0o When a delcomp operation is performed on the unnamed (default) model and no spectra are loaded, the model calculation is not updated. Our thanks to Laura Brenneman for pointing this out. Report added on Jan 21, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSUser/Handler/ xsDelcomp.cxx

12.5.0p This relaxes the OGIP requirement that spectral data files must contain a RESPFILE keyword, primarily to allow the loading of certain RXTE/PCA files. Our thanks to David Smith for pointing this out. Report added on Jan 30, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSModel/Data/ OGIP-92aData.cxx

12.5.0q A new option has been added to the tclout command: tclout gain. See the online tclout manual entry for proper syntax and usage. Prior to this, it was not possible to retrieve the values of gain parameters from tclout. Our thanks to Frank Haberl for pointing this out. Report added on Feb 03, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSUser/Handler/ xsTclout.cxx

12.5.0r Fix needed for all etable model calculations. Our thanks to Roderick Johnstone for pointing this out. Report added on Feb 12, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSUtil/Numerics/ LinearInterp.cxx

12.5.0s When both the absori and pexriv models are loaded during the same XSPEC session, whichever model is loaded second will not work properly. Note: this bug originated in version 12.5.0. Report added on Feb 13, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSFunctions/ xsabsori.f and xspexriv.cxx

12.5.0t This adds an option for choosing Y-axis units when plotting in setplot wave mode. The selection is made by the WAVE_PLOT_UNITS entry, which has been added to the new version of the Xspec.init file. The units may now be specified in Hz (the default for version 12.5.0), or angstroms as they were prior to 12.5.0. This applies to plots of data, counts, and all variants of model and ufspec plots. Report added on Feb 19, 2009.

This patch modifies heasoft-6.6/Xspec/src/manager/ plotLabels.dat, Xspec.init, src/XSPlot/Commands/ PlotModel.cxx, PlotUnfolded.cxx, src/XSPlot/Plot/ Plot.cxx, Plot.h, src/XSUser/Global/ Global.cxx and XSGlobal.cxx

12.5.0u Minor code changes mostly to clean up the messages reported when running XSPEC under the valgrind software tool. Report added on Feb 19, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSModel/DataFactory/ XspecRegistry.cxx, .h, src/XSUser/Global/ XSGlobal.cxx, src/XSUser/Handler/ xsExit.cxx, src/XSUtil/Utils/ XSstream.cxx, .h

12.5.0v Multiplicative model components which are created with the mdefine command should not be multiplied by the energy bin widths. Our thanks to Roderick Johnstone for pointing this out. Report added on Feb 19, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSModel/GlobalContainer/ MdefContainer.cxx, src/XSUtil/Parse/ MathExpression.cxx .h

12.5.0w A new tclout option has been added to make it easier to retrieve the fit parameters' sigma values. The syntax for this option is:

tclout sigma [< modelName>:]n

where n is the parameter number. If it is not a variable parameter or if the fit was unable to calculate its sigma, a value of -1.0 is returned. Report added on Mar 06, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSUser/Handler/ xsTclout.cxx

12.5.0x The model.dat entry for the vequil model is missing the parameter for Ar abundance, causing the vequil parameters which follow it to be misinterpreted in the code. (This bug does not affect the equil model.) Report added on Mar 06, 2009.

This patch modifies heasoft-6.6/Xspec/src/manager/ model.dat

12.5.0y The kerrconv convolution model code is still using the xspec11-only LMODDIR environment variable for locating the kerrtable.dat model data file. This should be modified for usage in xspec12, where LMODDIR doesn't exist. Report added on Mar 11, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSFunctions/ spin.f

12.5.0z This removes an ambiguous reference build error specific to gcc-4.1.1 on the Solaris-2.9 platform. Our thanks to Dacheng Lin for pointing this out. Report added on Mar 26, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSUtil/FunctionUtils/ FunctionUtility.cxx

12.5.0aa The diskir model goes to infinity when its rirr parameter = 1.0, which is also the default value of rirr's lower limit. Our thanks to Brian Refsdal for pointing this out. Report added on Mar 26, 2009.

This patch modifies heasoft-6.6/Xspec/src/manager/ model.dat and src/XSFunctions/ diskir.f

12.5.0ab The nsmax model function is only able to find its auxiliary files when it is run directly from XSPEC's model data directory (heasoft-6.x/spectral/modelData). Our thanks to Stephen Doe for pointing this out. Report added on Mar 31, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSFunctions/ nsmax.f

12.5.0ac Fixes to a couple of obscure cases of gain parameter usage: If a gain parameter belongs to a response temporarily replaced by a dummy response, or a gain parameter is indirectly removed through the data command erasing its associated spectrum and response, the gain shift may still be applied to a response occupying its former spectrum and source number. This patch also improves the show response output. Report added on Apr 06, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSModel/Data/ DataSet.cxx, src/XSModel/GlobalContainer/ DataContainer.cxx, ResponseContainer.cxx, .h, and src/XSUser/Handler/ xsShow.cxx

12.5.0ad The nthcomp model has an uninitialized variable for the case of input energies less than kT_bb/10^4, which may cause a crash to occur. Our thanks to Gulab Dewangan for pointing this out. Report added on Apr 14, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSFunctions/ nsthcomp.f

12.5.0ae For those linking the models library into their own programs, the swind1 model crashes when outputing a warning message as it indirectly accesses a variable intended for use only in XSPEC. Our thanks to Stephen Doe for pointing this out. Report added on Apr 14, 2009.

This patch modifies heasoft-6.6/Xspec/src/XSModel/Component/ TableComponent.cxx, src/XSModel/Component/OGIPTable/ FtoOGIPTable.cxx, and OGIPTable.cxx

12.5.0af The zredden multiplicative model component is calling the same function as redden, and therefore its redshift parameter has no effect. Our thanks to Brian Refsdal for pointing this out. Report added on May 05, 2009.

This patch modifies heasoft-6.6/Xspec/src/manager/ model.dat, src/XSFunctions/ functionMap.cxx, and .h

12.5.0ag When in setplot wave mode and the user's Xspec.init file entry for WAVE_PLOT_UNITS is set to angstrom, plot efficiency and plot icounts don't display due to a missing plot label error. Our thanks to Maurice Leutenegger for pointing this out. Report added on May 08, 2009.

This patch modifies heasoft-6.6/Xspec/src/manager/ plotLabels.dat


Older Versions:

Final issues/patches pages:
    12.4.0
    12.3.1
    12.3.0
Links to v11 bugs pages:
       v11 Bugs       v11 Bug reporters

Xspec Xspec Home Page


HEASARC Home | Observatories | Archive | Calibration | Software | Tools | Students/Teachers/Public

Last modified: Friday, 08-May-2009 12:14:29 EDT