------------------------------------------
------------------------------------------
Release Notes for stsci_python version 2.1
------------------------------------------
------------------------------------------
PyDrizzle changes:
-----------------
PyDrizzle has undergone some modifications to better support
MultiDrizzle and related tasks. Some key changes include:
- correcting use of 'blot' so that it works properly when the
original drizzle products used a non-unity scale, such as
WFPC2 data.
- expanding the WCSObject class to archive original WCS
keyword values and to support writing out a new WCS FITS
object.
- breaking up the 'bits' parameter into separate parameters
for single drizzling and final drizzling; namely,
'bits_single' and 'bits_final', respectively. This allows
DQ information to be used for both steps as desired, unlike
before, where input DQ arrays were only used for final
drizzling.
- allowing Python lists of filenames as input, along with a
shiftfile.
- adding support for NICMOS IDCTAB usage.
- properly supporting turning off context image generation
for single drizzling, reducing memory usage for that step
for large numbers of input images.
As a result, PyDrizzle now correctly supports a wider range of
datatypes more accurately than ever, especially WFPC2 and NICMOS
images. It also provides the user with better control over what
masking to use for both single and final drizzling, and over the
WCS information being used.
Dependency changes in this release:
----------------------------------
- Removed dependency on IRAF environment variable 'stsdas'.
It will now default to the current working directory for
default coefficients directory if 'stsdas$' is not defined.
- Removed all dependencies on DQPars module and classes.
- The function 'readShiftFile' was moved from 'buildasn' to
fileutil so that other tasks can use this function without
also needing to import 'buildasn'.
Interface changes in this release:
---------------------------------
- Replaced 'bits' parameter with 'bits_final' and 'bits_single'.
- EPAR interface change: removed 'use_mask', 'bits' and added
'bits_final', 'bits_single', and 'prodonly'.
- Added 'shiftfile' parameter as input parameter.
- Added support for Python list of filenames as input.
- The behavior of 'idckey' was changed such that a value of
''(blank) will cause PyDrizzle to default to instrument-specific
default cases and a value of None will result in no distortion
coefficients being applied.
- The 'build' attribute was added to the PyDrizzle class so
that it can be set when 'run()' method gets called, and used
in the 'clean()' method. This allows PyDrizzle to know that
it should not delete simple FITS output from drizzle if not
combined into a multi-extension output.
- The 'getMembers' and 'getMemberNames' methods were added
to the Observation classes to more readily support coordinate
transformations using PyDrizzle, especially for prototype
tweakshifts.
- The 'wtraxy' method was modified to work with list input as
well as single position input to better support coordinate
transformations with PyDrizzle.
- Added support for NICMOS IDCTAB usage, including support for
quadratic coefficients in IDCTAB.
- Modified reading of ASN tables to maintain order of filenames
and correctly identify when only 1 exposure gets read from an
ASN table.
- Correctly support use of 'blot' for images which were drizzled
using non-unity scale values; specifically, WFPC2 data. This
results in WFPC2 data being properly blotted back to correctly
align with the original input data.
Parlist changes in this version:
-------------------------------
- Added 'single_driz_mask' to the parlist to support separate
masks for single and final drizzle processing.
- Added 'nimages' to parlist to record the number of
files/images combined for this product. Used only to update
'NCOMBINE' if it exists in the SCI header.
Functionality changes in this version:
-------------------------------------
WCS Module 'wcsutil':
- WCS keywords are now archived within the image header allowing
them to be updated without losing the original values. Multiple
updates of the header will NOT overwrite archived keyword
values. Methods were added to support use of the archived values.
- Added 'createReferenceWCS' method to WCSObject class to support
output of WCS for use as a reference WCS with shiftfiles.
Required for 'tweak.py' (tweakshifts)
- A bug in the 'rd2xy' method was fixed.
- Additional help information has been added to the class level
docstring.
Mask file usage:
- Separate masks are now used for single drizzle and final drizzle
processing. The 'single_driz_mask' entry was added to the
parlist to support separate masks for single and final drizzle
processing.
- Problems with building mask files when no DQ array is present
in the input image were fixed, so that ACQ or RAW files can be
successfully processed if necessary.
- Names for the output mask images are built and remembered by
PyDrizzle now, regardless of whether they get used. This allows
external programs, such as MultiDrizzle, to have a consistent
filename to use when it builds its own mask for the input.
Operational changes:
- Logic for turning off context images during drizzling was
modified to work with final drizzling as well as single drizzling.
This now supports turning off context image building altogether
resulting in the same memory usage for processing 33 or more chips
as it would take to drizzle 2 chips.
- A bug in computing the RA and Dec values when applying shifts was
fixed. This bug caused a problem with the final rotation values
when a shiftfile was used.
Changes to output:
- Filename for the final output product will be derived DIRECTLY
from the rootname provided in the ASN table, including retaining
the case of the rootname. Previously, all output products used
all lower-case filenames.
- The Exposure class was modified to not expand DGEOFILE filename
when reporting the XGIM and YGIM drizzle parameters.
- Primary header output was modified to report NEXTEND == 0
when not building a multi-extension output file.
- Output to the 'D0*WTSC' keywords was changed to report value
of EXPTIME for wt_scl instead of the string 'exptime' or 'expsq'
to be consistent with IRAF 'drizzle' task output.
- The NCOMBINE keyword now gets updated with the correct number of
chips drizzled into the output image.
------------------------------------------
------------------------------------------
STSDAS v3.3.1 Patch Full Release Notes (excerpts)
------------------------------------------
------------------------------------------
Package stsdas.analysis.dither:
The MultiDrizzle and PyDrizzle tasks were significantly updated for
this release. The release notes describing these changes can be found
in:
http://www.stsci.edu/resources/software_hardware/pyraf/stsci_python/release_notes
All references to hidden tasks based on DQPars module were removed from
the Dither package.
Parameter file changes:
PyDrizzle
1. Removed: 'bits' parameter.
2. Added: 'bits_single' and 'bits_final' to replace 'bits'.
Code changes:
The initialization code in routines 'doblot.f', 'bieval.f',
'ioutil.f', and 'drutil.f' was modified so that the code would
compile under Tru64 without error.
A bug in cleanBlank that prevented the successful input of float
or integer values for optional parameters was fixed in the STSDAS
interface to MultiDrizzle.
The version ID was updated for Callable drizzle to Version 0.6 for the
callable drizzle and blot routines.
A bug was fixed in the 'traxy','wtraxy','tranback', and 'wtranback'
code to check for out of bounds pixels prior to calling 'drival'.
This avoids crashes when a GEOIM image has been specified.
|
 |
|
