# $Id: combFilter.py,v 1.13 2003/02/27 23:56:44 anderson Exp $
# ---------------------------------------------------------------------
# $Log: combFilter.py,v $
# Revision 1.13  2003/02/27 23:56:44  anderson
# undone the previous revision.  the addition of ramps filters to the
# delFilt list would have the effect of not producing catalogs for those
# filters.  This is likely not desirable behaviour.
#
# Revision 1.12  2003/02/27 20:57:58  jpb
# Added ramp filters to the delete list.
#
# Revision 1.11  2003/01/31 17:04:09  jpb
# Added multiplication of the detectionWeight image by edge masks, if
# found in the images directory.
#
# Revision 1.10  2002/09/13 15:33:15  anderson
# Revision to add new keywords PA_V3 and PA_FINAL to the list of
# copied keywords for the detectionImage header.
#
# Revision 1.9  2002/06/27 20:31:13  anderson
# update to include pyfits and numarray in the
# module message markup
#
# Revision 1.8  2002/06/20 21:07:44  anderson
# Revision to provide consistent filenames in messages with relative
# pathnames from the path described in the <root> element of each
# module message.  This was an update to this module's mkMsg method.
#
# Revision 1.7  2002/06/13 23:04:54  anderson
# added some robustness (try/except) to the deletion of the EXTEND keyword
# should pyfits ever decide to stop writing that keyword automatically
#
# Revision 1.6  2002/06/13 22:49:29  anderson
# Update to full implementation with pyfits and numarray.
#
# Revision 1.5  2002/05/29 22:02:19  jpb
# Allow a means for omitting images in specific filter from the produced
# detectionImage.  This is done via the "delFilters=" optional flag to the
# constructor, which defaults to the "_delFiltsDef" list; as of this revision,
# the content of this default list is just 'G800L' (i.e., don't use grism
# images for the detectionImage) but may be expanded in future to contain
# narrow-band filters, ramps, or whatever filter that we may want to
# process up through drizzling but not use for detectionImage generation.
#
# Revision 1.4  2002/05/22 14:37:20  anderson
# Revision addresses Bugzilla bug #1303:
# the only MIME type for FITS files is image/x-fits.
#
# Revision 1.3  2002/05/16 18:46:12  anderson
# Bringing all apsis modules to a common rev level.
# K Anderson
#
# Revision 1.1.1.1  2002/05/03 17:39:34  anderson
# initial revision and release of the ACS Science pipeline, apsis
#
# ---------------------------------------------------------------------
# created by K Anderson 30-03-01
#
# This module provides the detectionImage class which provides methods to create
# a detection image from n filter images. A list of filter images is provided by
# Observation object (obs.sciImageList).  setpars() simply writes a dummy .inpar
# file for SExtractor which sets a high detection threshold (DETECT_THRESH) so
# that no sources are found.  Sextractor is run with the getStats() method after
# the dummy .inpar file is written to produce noise and background statistics
# which are used in the generation of the detetion image. These stats are
# produced by SExtractor when VERBOSE mode is either NORMAL or FULL. 
# Here it is run in NORMAL mode.
#
# - modified to use the new observation attribute sciImageList.
# K Anderson
# 22-05-01
#
# allows use of pyfits to make the output detection image via the mkIm() method 
# - jpb.