Fermi Science Tools v11r5p3 Release Notes Updated March 1, 2018 The Fermi Science Tools have been updated to version v11r5p3. We have built and tested the tools on Scientific Linux 6 & 7, Ubuntu 16.04 & 17.10, Mac OS X El Capitan, and macOS Sierra. We have also tested but not built the tools on macOS High Sierra and Fedora 24, 26, & 27. To obtain the Science Tools, see the software download page at https://fermi.gsfc.nasa.gov/ssc/data/analysis/software/ which also includes installation instructions and a list of known bugs. ================================================================================ System Requirements ================================================================================ - Dropped support for all 32-bit systems - Dropped support for Scientific Linux 5, Fedora 20 & 21, Ubuntu 14.04 & 14.10 - Dropped support for OS X Mavericks and Yosemite - Added support for Scientific Linux 7, Ubuntu 16.04 & 17.10 - Added support for macOS El Capitan, Sierra, High Sierra ================================================================================ Major Updates ================================================================================ - The default Science Tools installation no longer uses the ROOT package. The configure script now defaults to the --without-root option instead of the --with-root option. - The observation simulator (gtobssim) has been included in non-ROOT builds. Several ROOT dependent models no longer work. If you need to use those models, we have created one Ubuntu 16.04 binary distribution that includes ROOT. - The orbit simulator (gtorbsim) input parsing as been completely revamped to resolve a number of issues and bugs. ================================================================================ Changes and Fixes ================================================================================ Structural Changes: - Configure now requires heacore/WCSLIB package to be built - CLHEP has been updated to version 2.2.0.8 from 2.1.0.1. - Xerces has been updated to version 3.1.4 from version 2.8.0. - Added leap second for 2017-01-01 - Split SkyProj into WCS and HEALPix based versions - Change to coefficients for FK5 -> Galactic coordinate conversion. - Multiple changes to support FermiPy. Data selection - Interpret evtype=[12] as convtype=[01] for Pass 7 files - Remove evclsm[in,ax] option from gtselect - Remove support for Pass 6 data - Added new hpx_region parameter - Switch to using healpix as an external IRFS & Response generation: - Added new method for evaluating PSF angular containment. - Adjusted edisp integration tolerance for Pass 8 - Improved accuracy of PsfIntegralCache to resolve issue with npred calculation in unbinned analysis. Likelihood: - Fixed gtdiffrsp crashes using the new wcslib 4.25.1 - Fixed gtlike issue when irf name used instead of CALDB - Bug fixes for FileFunction interpolation for cases where evaluations occur at energy end points of input spectrum - Implemented NpredValue for SummedLikelihood - gttscube application added - Implemented healpix-based fitting in ScienceTools - Added implementation of weighted binned likelihood fitting - Added RadialDisk & RadialGaussian spatial model classes - Allowed gtsrcmaps to use HEALPix input maps - Tweaked implementation of diffuse response calculation to improve accuracy when PSF is small. - Increased integration bounds in diffuse response calculation for large incidence angle events. - Added CompositeSource and associated functionality to Likelihood. - Added models for FL8Y source list compatibility. PyLikelihood: - Implemented NpredValue for SummedLikelihood - Added classes from gttscube application - Added RadialDisk & RadialGaussian spatial model classes - Allowed Npred and total_obs to return either weighted to unweighted versions. - Changed integral upper limits check integration range to check against, MLE rather than against lower limit. Other tools: - Updated Orbit Simulation to use more user-friendly timeline files - Updated SolarSystemTools for P8 event types. ================================================================================ Troubleshooting Tips ================================================================================ - On Mac OS X, you may see an error message of the form "dyld: Library not loaded: /opt/local/lib/libfreetype.6.dylib" Please see the installation instructions for a remedy. - If you run into a 'missing library' error when running a tool, verify that you have that library installed and that the *.so or *.dylib is the correct version. If not, try symlinking your version with a link that has the name as the one the tool is looking for. - You may encounter the error "Caught St13runtime_error at the top level: File not found:" when running some tools, e.g., gtexpcube2 and gtsuntemp. This error occurs when the "irfs" input parameter is set to CALDB and the optional input counts map is set to "none". The problem is that CALDB cannot find the EVENT_CLASS keyword in any of the input files and cannot determine the proper IRF to use. In these cases, you must explicitly set the IRFs to use (currently P8R2_SOURCE_V6). Note the irfs parameter may be a hidden option on some tools. Future versions of the tools will make the error message more explicit.