ChangeLog for rgsframes
=======================

Version 3.16.1 - 2004-02-16 (CG)
--------------
	+ TSTART and TSTOP added to events list keyword (SPR 2480)

VVersion 3.16 - 2003-06-09 (CG)
------------
	+ rgslib included in DEPEND (SPR 2440)

ersion 3.15 - 2002-03-12 (UL)
------------
	+ brought in line with cal-3.152.1
	  (observationStartDate->exposureStartDate)

Version 3.14 - 2002-05-10 (JBa)
------------
	+ Updated for usage of param-2.0

Version 3.13.2 - 2002-02-25 (IMS/LUX)
------------
	+ Fixed SOC SPR 2277 (comments left out of format specifications).

Version 3.13.1 - 2002-02-20 (IMS/LUX)
------------
	+ Fixed SOC SPR 2275.	

Version 3.13 - 2002-01-23 (UL)
------------
	+ fixed problem with exposure-looping in case of processall=false
	  (fixes SPRs-2257/2259)

Version 3.12 - 2002-01-15 (GV)
------------
	+ write SUBMODE to output dataset, CCDMODE to table.
	
Version 3.11 - 2002-01-09 (JBa)
-----------
	+ SOC-SPR 2216 identifies a whole different problem:
	  0180_0111080101_R2S00503SPE.FIT is completely wrong!
	  Nevertheless, rgsframes is now using a stack instead of allocating
	  huge matrices in order to find duplicate frame entries.
	  This saves memory, as well as a much faster algorithm.

Version 3.10 - 2002-01-08 (JBa)
-----------
	+ SOC-SPR 2245 triggered a bug in rgsframes: rgsframes tried to release an auxiliary file,
	  that was never opened.

Version 3.9 - 2001-11-15 (JBa)
-----------
	+ adopted common naming scheme for all RGS tasks.

Version 3.8 - 2001-10-31 (CE)
-----------
	+ corrected error in parsing of instId from CAL (at case
	  statements); error was introduced in v 3.7

Version 3.7 - 2001-10-26 (CE)
-----------
	+ changed --instrument parameter to rgs1|rgs2

Version 3.6.1 - 2001-09-04 (CE)
-----------
	+ removed hard-wired check of valid CCD-ID's; SPR-2161

Version 3.6 - 2001-07-24 (CE)
-----------
	+ corrected bug in main program when checking valid CCD-ID's
	+ changed sequence of arguments to function findDuplicates
	+ in rgsframesutils: new algorithm for function findDuplicates and
	  over-loading added
	+ sorting EXPOSURE table now before searching for duplications
	+ added sorting of PIXELS table
	+ replaced the use of the variable INDEX with variable IDX
	  (because INDEX is an f90 intrinsic)

Version 3.5 - 2001-06-21 (CE)
-----------
	+ support for HTR mode added
	+ added possibility to loop over all CCD's inside the task - this
	  is mainly to enhance the processing speed for HTR mode, as
	  otherwise significant overhead is contained in the repeated
	  calculation of TIME; all CCD's event list files need to be
	  opened anyway for this calculation; parameter 'processall'
	+ GTI table renamed to STDGTI
	
Version 3.4 - 2001-04-24 (CE)
-----------
	+ added attributes OBS_MODE, FILTER, OBJECT, OBSERVER to primary
	  table
	+ added layout file

Version 3.3 - 2001-04-12 (CE)
-----------
	+ added attributes INSTRUME & CCDID to EXPOSURE table

Version 3.2 - 2001-04-11 (CE)
-----------
	+ added check for number of bad pixels after CAL_getBadPixelList,
	  as otherwise no bad pixels cause an array boundary error

Version 3.1 - 2001-04-08 (CE)
-----------
	+ renamed EXPOSU table to EXPOSURE
	+ brought documentation in line with changes since 3.0

Version 3.0 - 2001-04-06 (CE)
-----------
	+ renamed FRAMES table to EXPOSU
	+ removed columns SEQINDEX, REJPIX0, REJPIX1
	+ renamed column FRAMETIME to TIMEDEL
	+ added calculation of fraction of active surface and stored in
	  columns FRACEXP0, FRACEXP1
	+ default of parameter --withratecolumn=No
	+ removed timepatch parameter; a change in the OAL did not make
	  this necessary any more

Version 2.2 - 2001-04-04 (CE)
-----------
	+ fixed bug in application of timepatch; this bug manifested
	  itself with odffix-ed data only. The EOS should be subtracted
	  from the Obt only, not from TIME.

Version 2.1 - 2001-04-04 (CE)
-----------
	+ removed leftover print* statement in rgsframes_mod.f90

Version 2.0 - 2001-03-21 (CE)
-----------
	+ re-write and cleanup of the entire code
	+ cleanup FRAMES and PIXELS table with duplicate entries
	+ bugfix of contents of REJPIX0/1: this now holds the upper
	  rejected pixels (used to be pixels below REJ threshold).
	+ bugfix in frametime calculation: now repeating readout of CCD's
	  is properly supported
	+ removed parameter alwayssortaux: sorting of the AUX table is
	  always performed
	+ removed parameter temporaryset: this is not required any more
	+ documentation updated
	
Version 1.7 - 2000-12-14 (GV)
-----------
	+ there was another warning as below.

Version 1.6 - 2000-12-12 (GV)
------------
	+ make two warnings messages (SOC-SPR-1862)
	
Version 1.5 - 2000-12-01 (GV)
-----------
	+ (config/rgsframes.par) add temporaryset parameter
	(SOC-SPR-1881). It defaults to the old hard wired value (tmpSet.ds).
	
Version 1.4.2 - 2000-11-22 (GV)
-------------
	+ fix documentation problem SOC-SPR-1856.
	
Version 1.4.1 - 2000-10-31 (GV)
-------------
	+ small change to doc (remove input of rgsproc file), trying to fix a documentation build problem.
	
Version 1.4 - 2000-08-29 (PV)
------------
- fixed bug in frameExposureTimes() SPR-1737

Version 1.3 - 2000-08-02 (PV)
------------
- uses DAL 1.125 setData() to access unsigned int16 column eosfine.
- using qualifiedname() rather than name() in messages and errors.
	
Version 1.2.3 - 2000-06- (PV)
------------
- closed SPR-1630 : Die gracefully on attempts to process HTR mode data.
- closed SPR 1615 : contains oldtestfiles
- closed SPR 1616 : remove doc/rgsframes_description.tex.lalit
	
Version 1.2.2 - 2000-06-15 (PV)
------------
-  warning (duplicateFrames) changed into an error. src/rgsframesutils.f90
  (fixes SPR-1389) 

Version 1.2.1 - 2000-06-07 (PV)
------------
- also processes readout sequences in which the same CCD occurs twice or
  more in the readout sequence. (fixes SPR-1360)
- added check to verify  ccdnr and seqence ID match with sequence in aux2 table.
	
Version 1.2 - 2000-05-25 (PV)
------------
- fixes minor bug related to timestamp of first frame,
- .info file added
	
Version 1.1 - 2000-05-12 (PV)
------------
- flag column of FRAMES table renamed from FRAMEFLAG to FLAG (EVATT_COLUMN_NAME)
- uses setEventAttribute() to add EVATT_IN_BAD_FRAME bit pattern to table header.
- frame timestamps now are mid of frame exposure.
	
Version 1.0 - 2000-05-03 (PV)
------------
- renamed to v1.0 to make various people happy 
- minor changes to doc only.

Version 0.53 - 2000-05-02 (PV)
------------
- added warning for duplicated frame numbers in AUX file.

Version 0.52 - 2000-04-20 (PV)
------------
- doc updated. Ready for approval.  

Version 0.51 - 2000-04-20 (PV)
------------
- re-added time patch which subtracts first eoscoars value from ObtTag
  returned by OAL. Apparently it is still needed with current OAL.

Version 0.50 - 2000-04-19 (PV)
------------
- restructured code.
- removed looping over ccd's
- parameter "sets" renamed to "set"
- parameter "outputsets" renamed to "outset"
- allow both for filtering in maxrawpixels and maxrawpixel rate using 
parameters: withmaxrawpixels maxrawpixels withmaxrawpixelrate maxrawpixelrate
		
Version 0.49 - 2000-04-18 (PV)
------------
- added optional PIXELRATE column to FRAMES table (#pixels/frame)
  Algorithm to calculate pixelrate value is very slow.
- added optional ratefiltering:
   withratefiltering, b,h, No,,,"mark frames bad with pixelrate above given level"
   pixelrate, i,h, 99999, 0,,"frames with more pixels than pixelrate are flagged bad "
	
Version 0.48 - 2000-04-17 (PV)
------------
- marks frames as bad in following cases:
	(nlostevt /= 0)     
        (abortflg /= 2)  
        (ndpp /= (windowdx*windowdy)))
- added parameter "minexposuretime" with default 150ms.
  frames with exposuretimes < minexposuretime are marked as bad.	
	

Version 0.47 - 2000-04-14 (PV)
------------
- parameters "infiles" "outfiles" renamed to "sets" and "outputsets" (SPR 820)
- GTI stuff moved to src/gti_mod.f90
	
Version 0.46 - 2000-04-13 (PV)
------------
- creates proper GTI table. (ie. badframes/ missing frames result in multiple GTI intervals)
- parameter "timepatch" removed. (obsolete)	

Version 0.45 - 2000-04-07 (PV)
------------
- creates valid DUMMY GTI table which marks whole observation as good.
- auxfile from OAL (parameter 'auxfile' removed)
- dppversion from CAL (parameter 'dppversion' removed) 
  requires new testccf. 
	
Version 0.44 - 2000-03-14 (PV)
------------
- keyword TELAPSE added to PIXELS table

Version 0.43 - 2000-02-23 (PV)
------------
- updated for new tablesort in saslib 1.58

Version 0.42 - 2000-02-21 (PV)
------------
- correctWrapArround() removed from rgsframesutils.f90 
	(now in saslib)

Version 0.41 - 2000-02-10 (PV)
------------
+ uses saslib copySomeAttributes() to copy attributes.

Version 0.40 - 2000-02-07 (PV)
------------
+ copy attributes from PIXELS table to set.

Version 0.39 - 2000-02-02 (PV)
------------
+ updated implementation of frame exposure time which should be able to
	cope with lost frames and a unsorted auxilary table. 
	
Version 0.38 - 2000-01-27 (PV)
------------
+ First implementation of calculation of frame exposure time using
  eoscoars and eosfine from AUX file. (need check if lost frames are
  properly taken into account)
+ flag first frames as bad .
+ updated framenumber overflow algorithm.	

Version 0.37 - 2000-01-14 (PV)
------------
- framenumber overflow patched.

Version 0.36 - 2000-01-13 (PV)
------------
- time correction patch added for odffixed produced TCS (Time Correlation File)
- creation of empty badpix table removed. (done by badpix task)	
	
Version 0.35 - 1999-12-20 (PV)
------------
- testharness updated. CVS conflicts removed.
		
Version 0.34 - 1999-12-19 (Marco Beijersbergen)
------------
+ updated OAL_setState to oal-3.42.

Version 0.33 - 1999-11-09 (PV)
------------
+ FRAME_TIME as real32 in sec. was real64 msec.
+ WINDOWX/Y0 keywords value incremented by 1
+ 'deadtime' calculation replaced by #rejected pixels REJPIX0 REJPIX1
+ copying of datasets modified (DAL rename replaced by copyDataset).
+ clobber parameter removed.
+ dummy timestamp removed.

Version 0.32 - 1999-10-05 (PV)
------------
+ Changed mapping ser to shape and grade
+ new parameter dppversion added
+ use of DAL NULL values for shape

Version 0.31 - 1999-09-27 (PV)
------------
+ added columns TYPE and BADFLAG to (empty) badpix table
+ keyword "DATAMODE" added to set
	
Version 0.30 - 1999-09-25 (GV)
------------
+ patch test harness to make it work with new testodf.

Version 0.29 (PV 22sep99)
-----------
+ add ODFNAME attribute to primary header

Version 0.28 (PV 10sep99)
-----------
+ create all columns of FRAMES table even in case of no events.

Version 0.27 (PV 07sep99)
-----------
+ fixed for nameclash clobber
+ test for exist before removing keywords FILENAME CREATOR CATEGORY	
	
Version 0.26 (PV 10aug99)
-----------
+ fixed for processing empty tables (new scisim)
	
	
Version 0.25 (PV 05aug99)
-----------
+ fixed for rgsevents 1.4
    - proper SHAPE values
    - empty badpix table
			
Version 0.23 (PV 02aug99)
-----------
+ fixed for rgsevents 1.2
    - dummy 1 row badpixtable
    - dummy grade shape columns
	
Version 0.22 (PV 11jun99)
-----------
+ added EMPTY badpix table to make output compatible with rgsx 0.3

Version 0.21 (PV 07jun99)
-----------
+ fixed for cal 3.0 and saslib 1.34

Version 0.20 (PV 01jun99)
-----------
+ changed column name CCDNODE into CCDNODES for aux2 table 
  according to ODF ICD.
	
Version 0.19 (PV 29apr99)
-----------
+ added testodf to DEPEND file (SPR 634) 

Version 0.18 (PV 21apr99)
-----------
+ added setting cal state from dataset
- renamed a few variables and removed unused ones
	
Version 0.17 (PV 14apr99)
-----------
+ updated messaging for error 1.16

Version 0.16 (PV 07apr99)
-----------
-  testscript modified to use input files from odfdir
	
Version 0.15 (PV 17mar99)
-----------
-  fixes so frames can handle both RGS1 and RGS2. tablenames as parameter 
   removed.
-  reads first block in aux file to find out which instrument we have. 	
	
Version 0.14 (PV 16mar99)
-----------
-  added boolean parameter dummytimestamp to disable OAL time calls.
	
Version 0.13 (PV 5mar99)
-----------
-  added OAL time calls (commented out at the moment)
-  added headArray function to prevent errors writing errstr	

Version 0.12 (PV 3mar99)
-----------
- commented out some messages causing crash dumping big arrays. 

Version 0.11 (PV 26feb99)
-----------
- uses saslib odfNames for column names
- uses saslib eventAttributes  	
	
Version 0.10 (PV 21feb99)
-----------
- fixes for empty eventlists

Version 0.9 (PV 15feb99)
-----------
- changes for CALv2.3 OALv3.0
- updated messaging
	
Version 0.8 (PV 05feb99)
-----------
- patched Lalits code to make it work with f95.
- Compiles and runs but NOT SURE OUTPUT IS CORRECT
	
Version 0.7 (PV 27jan99)
-----------
- Hardcoded CCFCIF path taken out. Package runs with CCFIF=/data/transport/testccf
- write(errstr,*) statement taken out. Crash when writing more than 4Kdata in it.
	
Version 0.6 (PV 26jan99)
-----------
- Package taken over by PV from LJ. Code compiles and produces output.
- deadtimefraction column changed from double to single.	
	
Version <0.5>
----------------------

This the latest version which has much functionality for sepectroscopy mode.
The only thing missing, apart from a damn good testing, is the timing info.

Open SPRs:

Version 0.1
-----------

 - first implementation.
