ChangeLog for eboxdetect
===============================

	
Version 4.15.1 -  2004-01-20 GL
-------------------------------	

Same as 4.17 - for release track
Removed test output
	
	
Version 4.17 -  2004-12-21 GL
-------------------------------	

Changed ebox_io.f90 (subroutine wr_stab) to enable raster scans.
	
Version 4.16 -  2004-12-02 GL
-------------------------------

Improve resolution of closeby sources in 5x5 box mode:
     - Smooth SN map lfeld with tapered 5x5 kernel instead box average.
     - Always use 3x3 box in soubroutine 'match' to find local maxima.
	

	
Version 4.13.3 -  2004-10-06 GL
-------------------------------

Average input background map over detection box
Close SPR SSC-SPR-3399: Spurious sources near chip gaps.
	
	
Version 4.13.2 -  2004-08-25 GL
------------------------------

Total likelihoods in multi-instrument runs 
are now corrected using the effective number of input images
(where the source is inside the detection mask).

	
Version 4.13.1 -  2004-03-16 GL
------------------------------

Correction in documentation
	
Version 4.13 -  2003-12-08 GL
------------------------------

Make use of param v2 features in .par file.

	
Version 4.12 -  2002-10-30 GL
------------------------------
(development track version)
	
Fixed DEPEND file
Renamed column SIGMA to LIKE
Removed Warning: "CROTA2 missing"
Closed SPRs: 
  +SSC_SCR-2966 Source buffer overflow
  +SSC_SCR-3009 Source buffer overflow (uncomp timing mode)



Version 4.8 - 2002-05-24 GL
-----------------------------

Converted .par file to XML
	
Version 4.7.2 - 2002-05-16 HB
-----------------------------

Closed SPRs:
+SSC-SPR-2836 wrong source counts formula in documentation	
+SSC-SPR-2862 (on eposcorr) inconsistent lii/bii,lii_corr/bii_corr values:
	      constant 'pi' set to double precision (also fixed in
   	      emldetect)
	
Version 4.7.1 (2001-03-08) HB
-----------------------------

EXPIDSTR & ATT_SRC propagated from input

Closed SPR:
+SSC-SPR-2647  Can we have optical axis position please?
+SSC-SPR-2803 	NaNs in multi-camera source lists
	
Version 4.7 (2001-11-21)
------------------------

emldetect 4.7 added to DEPEND	
	
Version 4.6 (2001-11-07)
------------------------

Closed SPR:
+ SSC-SPR-2621: routines common to eboxdetect and emldetect now called
	        from emldetect library. Module edetect_io renamed
	        to edetect_io_box
		
Version 4.5 (2001-10-15)
------------------------

Closed SPR:
+ SSC-SPR-2592 need to account for OOT events
  Rates and fluxes now divided by the following OOT correction factors:
  PN FF mode: 0.9411;  PN eFF mode: 0.97815
  Source counts (SCTS column) and other modes/cameras are left uncorrected	 		
Version 4.4 (2001-09-12)
------------------------

+ test output removed	
	
Version 4.3 (2001-08-28)
------------------------

+ source buffer size increased 	
	
Version 4.2 (2001-07-25)
------------------------

+ detection likelihoods, L, are now calculated such that, independently
  of the number of input images, they always obey the definition L=-ln(p) 
  where p is the probability that the observed counts are due to Poissonian 
  fluctuations of the background	
+ the task now exists with an error message if any of the input
  images are empty	
	
Closed SPR:
+ SSC-SPR-2463 SCR 67: Calibration quantities in output source lists	
	
Version 4.1 (2001-04-10)
------------------------

Fixed bug in calculation of likelihood
Removed diagnostic output
	
	
Version 4.0 (2001-02-28)
-------------------------

Closed SPRs:

+ SSC-SPR-2275 Energy band wanted
+ SSC-SPR-2273 Documentation
+ SSC-SPR-2271 BOX_SIZE should be in units of pixels
+ SSC-SPR-2270 DIST_NN should be in arcseconds
+ SSC-SPR-2132 does not trap detmask from wrong camera
+ SSC-SPR-2065 FITS errors in ouput
+ SSC-SPR-2223 Count rate evaluation with SAS

eboxdetect now uses medium accuracy PSF from CAL 
to correct for out-of-box counts.
Introduced 2 new parameters "pimin" and "pimax".
New columns BOX_CTS, BG_RAW, and EEF in output table.


Version 3.6 (2001-02-13)
--------------------------

Closed SPRs:
+ SSC-SPR-2149 Ignores the BAND keyword	
+ SSC-SPR-2234 definition of hardness ratios	

Version 3.5.2 (2000-11-09)
--------------------------

+ definition of hardness ratio 3 changed (on JOs request).
	
	
Version 3.5.1 (2000-10-20)
--------------------------	

Closed SPR:

+ SSC-SPR-1992 test harness fails on linux
	
Version 3.5 (2000-09-29)
------------------------
	
- Version changed to 3.5
	
	
Version 3.4.1 (2000-09-29)
---------------------------
	
- V3.4 contained an obsolete vesion of module ebox_io. Corrected in v3.4.1.
	
Version 3.4 (2000-09-28)
-------------------------

+ Code to prevent the overflow of the source buffer was added.
	
closed SPRs:

+ SSC-SPR-0730  like_min description	
+ SSC-SPR-0733  errors computation
+ SSC-SPR-0734  General documentation
+ SSC-SPR-0737	Verbosity
+ SSC-SPR-0786  Algorithm description
+ SSC-SPR-1078  Parameter layout file
+ SSC-SPR-1084  Hardness ratios
+ SSC-SPR-1085  Detection over several image
	
	
Version 3.3.4  2000-07-04
----------------------------

+ sla added to DEPEND file	

	
Version 3.3.3  2000-07-03
----------------------------

+ inconsistent .par file and documentation corrected	
	

Version 3.3.2  2000-07-02
----------------------------

+ galacic coordinates now calculated using slalib
+ column DIST_NN filled


Version 3.3.1 (June 28, 2000)
-----------------------------

+ HRs outside [-1,1] range corrected
+ exposure for sources at chip borders corrected 
+ unused fields in output list now contain null values

Closed SPRs:

+ 1235 Task exits without error, message or creating outpu
+ 1470 EBOXDETECT crashes
+ 1638 EBOXDETECT does not create output
+ 1639 Strange false detections
+ 1659 wrong format for errors and warnings in documentation
+ 1750 eboxdetect terminating in extended source field
+ 1886 eboxdetect SEGV with NAG F95 V4.0 on Tru64 Unix


Version 3.3 (March 13, 2000)
----------------------------

- HR3 and hardness ratio errors corrected.
	
	
Version 3.2 (February 22, 2000)
-------------------------------

- Problem related to the error calculation which let the task crash
  if the PN is not the first instrument corrected	 

Version 3.1 (February 18, 2000)
-------------------------------

- DEPEND file corrected
- Error columns in source list filled	

	
Version 3.0 (January 27, 2000)
------------------------------

- Source list format adjusted to comply with recent DCPs.
- Task now can handle several exposures per instrument.
- Task now can handle I1, I2, I4, R4, and R8 input images.
- Offsets between different instruments as determined by task eident
  are now read and applied to the input images. Two command line
  parameters were added to control whether the eident output file
  is read.	   
- The pixel position of the optical axis is now calculated from
  the image keywords (used to be set to the center of the image).  	 

	
Version 2.0 (September 14, 1999)
--------------------------------

- Input parameter boxsize added to control whether 3 x 3 or 5 x 5 pixel
  detection box is used.
- Fraction of PSF in source box and background box is now calculated
  as a function of the off-axis angle.	
- Smallest permitted distance between sources now depends on the
  respective detection likelihoods.	
- Error in analytical PSF corrected. 	

	
Version 1.12 (August 4, 1999)
-----------------------------

- task now accepts one detection mask per instrument
	
Closed SPRs:

  - 1076: exposure map use (sentence removed from agorithm description)
  - 1079: parameter type for boxlistset changed.	
  - 1081: exposure values if withexpimage=false
  - 1083: ID_BAND now always 0 for summary bands.
  - 1081: 0.5 pixel source position offset corrected
  - 1161: with the above change (one detection mask per instrument)
	  the task now handes up to 3 instruments with up to 
	  6 energy bands each.

Open SPRs: 0733,0735,0737,0742,0762,1078,1084,1085

	
Version 1.11 (August 3, 1999)
-----------------------------

- one more error in RA, DEC calculation corrected
- task now looks for CROTA2 keyword and assumes 0 of not present	
- max. filename length changed to 1024 (this didn't work in v1.10)	

Closed SPRs:

  - 1077: program now requires one exposuremap per band
	  and complains if less than the required number of
	  maps are supplied.

	
Version 1.10 (July 29, 1999)
----------------------------

- error in RA, DEC calculation corrected
- partial update of description (more to follow)
	
Closed SPRs:
 
  - 0730: description of likelihood parameter	  
  - 1114: filename length changed to 1024	

Open SPRs: 0733,0735,0737,0742,0762,1076-1085

	
Version 1.9 (July 12, 1999)
---------------------------

- paramter names changed to conform to convention

Closed SPRs:

  - 0726: expimagesets and withexpimage parameters (renamed) 
	  are now in the documentation 	
  - 0731 & 0735: ecf paramter now in documentation and 
	         wrong type of ecf parameter in .par file corrected	
	
Open SPRs: 

  - 0730,0786: items missing from the documentation
  - 0733,0735,0737,0742,0762:  algorithmic issues
	

Version 1.8 (July 8, 1999)
--------------------------
	
Closed SPRs:

  - 0551: Smaller test files	
  - 0742: BOX_SIZE column in source table filled
  - 0744: BG_MAP negative
  - 0785: WCS keywords and RA, DEC calculation	
  - 0981: taskmain added to DEPEND	

Open SPRs:

  - 0726,0730,0731,0734,0786: items missing from documentation 
  - 0733,0735,0737,0742,0762:  algorithmic issues

	
Version 1.7 (June 18, 1999)
---------------------------
	
 - now performs simultaneous source detection in multiple energy bands
 - accepts arbitrarily sized input images
		
Version 1.5
----------------------	

To do list added

Closed SPRs:
 
 - 0071 & 0072: get_files and cp_head were moved to module edetect_io
	 which is used by all AIP SAS tasks
 - 0073: DAL used to read parameter lists
 - 0504: *.f code changed to *.f90; date and time calls removed 
 - 0516: "checkoutput" changed to "./checkoutput" and cp command
         removed from test/eboxdetect_test	
	
Version 1.4
----------------------	

 error in routine exdmin corrrected.	
	
Version 1.3
----------------------
	
 test harness changed: A f90 program is used to compare the output source 
	               parameters with a reference dataset.
	
Version 1.2
----------------------

 test harness changed: Three different parameter settings are tested.  	
 eboxdetect.par changed: ecf (energy conversion factors) added to list
	                 of parameters. 
	
Closed SPRs:

 - 0292: Test files are now gzip'ed to save disk space.	
 - 0298: CLEANFILES in eboxdetct/test/Makefile edited.
 - 0323: Functionality added: taks now perfomrs source detection
	 on single fields in both local and map mode.
 - 0324: Makefile on eboxdetect/test edited	
 - 0462: HDUCLASS and HDUCLAS1 added	
 - 0463: EXTNAME changed to SRCLIST
 - 0467: "draft" in task description deleted	
	
Version 1.1
----------------------

ChangeLog added

Closed SPRs:

 - 0065: test harness is more robust now
 - 0074: "
 - 0067: .par file provided instead of .prm
 - 0068: fatal changed to error	

Open SPRs: (will be treated in next task version)

 - 0066: test_plan
 - 0069: dataset opened twice	
 - 0071: get_files to be replaced by generic mechanism
 - 0072: cp_head to be replaced by generic mechanism 	
 - 0073: generic mechanism for parsing lists

Version 1.0
----------------------------

- Original version submitted to the SOC

To do list:
------------	

- add multi band option (done: V1.7)
- add matched filter option
- add error handling and verbosity control