=====
**Available under SSBX/IRAFX starting:** Nov 2, 2015
This version builds upon the major set of changes implemented in v2.0.0 by not
only fixing some bugs, but also cleaning up/changing/revising some APIs and
docstrings. The complete list of changes includes:
- [API Change] The 'updatewcs' parameter was removed from both the
``astrodrizzle`` and ``tweakreg`` interactive TEAL interfaces.
The 'updatewcs' parameter can still be used with the Python interface for
both the ``astrodrizzle``. ``astrodrizzle``() and ``tweakreg``. Call the
``stwcs.updatewcs.updatewcs()`` function separately before running
``astrodrizzle`` or ``tweakreg``.
- [API Change] The stand-alone interface for the blot routine
(``ablot.blot()``) has been revised to work seamlessly with
astrodrizzle-generated products while being more obvious how to call it
correctly. The help file for this task was also heavily revised to document
all the input parameters and to provide an example of how to use the task.
- [API Change] Coordinate transformation task
(``pixtopix``/``pixtosky``/``skytopix``) interfaces changed to be more
consistent, yet remain backward-compatible for now.
- Both ``astrodrizzle`` and ``tweakreg`` now return an output CD matrix which
has identical cross-terms indicating the same scale and orientation in each
axis (an orthogonal CD matrix). This relies on a revision to the
``stwcs.distortion.utils.output_wcs()`` function.
- The user interfaces to all 3 coordinate transformation tasks now use
'coordfile' as the input file of coordinates to transform. The use
of 'coords' has been deprecated, but still can be used if needed. However,
use of 'coordfile' will always override any input provided simultaneously
with 'coords' parameter. Help files have been updated to document this as
clearly as possible for users.
- User-provided list of input catalogs no longer needs to be matched exactly
with input files. As long as all input images are included in input catalog
list in any order, ``tweakreg`` will apply the correct catalog to the
correct file.
- ``tweakreg`` has been updated to correctly and fully apply source selection
criteria for both input source catalogs and reference source catalogs based
on ``fluxmin``, ``fluxmax`` and ``nbright`` for each.
- All use of keyword deletion has been updated in ``drizzlepac`` (and
``fitsblender``) to avoid warnings from astropy.
- All 3 coordinate transformation tasks rely on the input of valid WCS
information for the calculations. These tasks now warn the user when it
could not find a valid WCS and instead defaulted to using a unity WCS, so
that the user can understand what input needs to be checked/revised to get
the correct results.
- Exclusion/inclusion region files that can be used with ``tweakreg`` can now
be specified in image coordinates and sky coordinates and will only support
files written out using DS9-compatible format.
- The filename for 'final_refimage' in ``astrodrizzle`` and 'refimage' in
``tweakreg`` can now be specified with OR without an extension, such as
'[sci,1]' or '[0]'. If no extension is specified, it will automatically
look for the first extension with a valid HSTWCS and use that. This makes
the use of this parameter in both place consistent and more general than
before.
- The reported fit as written out to a file has been slightly modified to
report more appropriate numbers of significant digits for the results.
- Use of astrolib.coords was removed from ``drizzlepac`` and replaced by use
of astropy functions instead. This eliminated one more obsolete dependency
in our software.
- Code was revised to rely entirely on ``astropy.wcs`` instead of stand-alone
pywcs.
- Code was revised to rely entirely on ``astropy.io.fits`` instead of
stand-alone pyfits.
- Added ``photeq`` task to account for inverse sensitivity variations across
detector chips and/or epochs.
- WFPC2 data from the archive with ``DGEOFILE`` reference files will now need
to be processed using ``stwcs.updatewcs`` before running them through
``astrodrizzle`` or ``tweakreg``. This update converts the obsolete,
unsupported ``DGEOFILE`` correction for the WFPC2 data into a ``D2IMFILE``
specific for each WFPC2 observation, then uses that to convert the WCS based
on the new conventions used for ACS and WFC3.
This set of changes represents the last major development effort for
``DrizzlePac`` in support of HST. Support of this code will continue
throughout the lifetime of HST, but will be limited primarily to bug fixes
to keep the code viable as Python libraries used by ``DrizzlePac`` continue
to develop and evolve with the language.