Fermipy

------------------

* Bug fixes and various refactoring in TSCube and CastroData. Classes
for reading and manipulating bin-by-bin likelihoods are now moved to
the `~fermipy.castro` module.
* Rationalized naming conventions for energy-related variables.
Properties and method arguments with units of the logarithm of the
energy now consistently contain ``log`` in the name.

* `~fermipy.gtanalysis.GTAnalysis.energies` now returns bin energies
in MeV (previously it returned logarithmic energies).
`~fermipy.gtanalysis.GTAnalysis.log_energies` can be used to
access logarithmic bin energies.
* Changed ``erange`` parameter to ``loge_bounds`` in the methods
that accept an energy range.
* Changed the units of ``emin``, ``ectr``, and ``emax`` in the sed
output dictionary to MeV.

* Add more columns to the FITS source catalog file generated by
`~fermipy.gtanalysis.GTAnalysis.write_roi`. All float and string
values in the source dictionary are now automatically included in
the FITS file. Parameter values, errors, and names are written to
the ``param_values``, ``param_errors``, and ``param_names`` vector
columns.

* Add package script for dispatching batch jobs to LSF (``fermipy-dispatch``).

* Fixed some bugs related to handling of unicode strings.

------------------

* Added new variables to source dictionary:

* Likelihood scan of source normalization (``dloglike_scan``,
``eflux_scan``, ``flux_scan``).
* Source localization errors (``pos_sigma``,
``pos_sigma_semimajor``, ``pos_sigma_semiminor``, ``pos_r68``,
``pos_r95``, ``pos_r99``, ``pos_angle``). These are automatically
filled when running `~fermipy.gtanalysis.GTAnalysis.localize` or
`~fermipy.gtanalysis.GTAnalysis.find_sources`.

* Removed camel-case in some source variable names.
* Add ``cacheft1`` option to :ref:`config_data` disable caching FT1
files. Cacheing is still enabled by default.
* Support FITS file format for preliminary releases of the 4FGL
catalog.
* Add ``__future__`` statements throughout to ensure
forward-compatibility with python3.
* Reorganize utility modules including those for manipulation of WCS
and healpix images.
* Various improvements and refactoring in
`~fermipy.gtanalysis.GTAnalysis.localize`. This method now moved to
the `~fermipy.sourcefind` module.
* Add new global parameter ``llscan_pts`` in :ref:`config_gtlike` to
define the number of likelihood evaluation points.
* Write output of `~fermipy.gtanalysis.GTAnalysis.sed` to a FITS file
in the Likelihood SED format. More information about the
Likelihood SED format is available on this `page
<http://gamma-astro-data-formats.readthedocs.io/en/latest/results/binned_likelihoods/index.html>`_.
* Write ROI model to a FITS file when calling
`~fermipy.gtanalysis.GTAnalysis.write_roi`. This file contains a
BINTABLE with one row per source and uses the same column names as
the 3FGL catalog file to describe spectral parameterizations. Note
that this file currently only contains a subset of the information
available in the numpy output file.
* Reorganize classes and methods in `~fermipy.sed` for manipulating
and fitting bin-by-bin likelihoods. Spectral functions moved to a
dedicated `~fermipy.spectrum` module.
* Write return dictionary to a numpy file in
`~fermipy.gtanalysis.GTAnalysis.residmap` and
`~fermipy.gtanalysis.GTAnalysis.tsmap`.