Important changes from Release 1.0 up to 02/09/2005:

wj: 19/02/2006:
   oirFormFringes.c:

   added -removeAverage option 
      if specified, this computes the average (over wavelength)
      of each spectrum and subtracts the average from each pixel.
      This removes artefacts at zero OPD in delay frunction, but
      can also remove signal when the actual OPD is in fact zero.

      if NOT specified (DEFAULT): no average subtraction.  For
      faint sources the artefacts at zero OPD may confuse the
      fringe finder

   added -fixopd option

      if specified, VLTI delay line OPDs are multiplied by 0.5.
      The corrects (infrequent) error in VLTI delay control system
      when they leave it in autocolumate mode.

      if NOT specified (DEFAULT) leave delayline OPDs alone.

  added -no20 option

      if specified an attempt is made to filter out 20 channel pattern
      noise on MIDI detector.  This noise pattern appeared mid-2005
      and this filtering option seems to help.  If the electronics
      are fixed it will not be necessary

      if NOT specified (DEFAULT) no filtering is done.

oirChopPhotometry.c

   added onslit sky subtraction function, and option -dSky dSkyValue

   previously sky subtraction was done by averaging the SKY images and
   subtracting this from the average of the TARGET images.  For faint
   sources and dubious weather this leaves residuals comparable to
   the source.   

   In the new version 5 rows at the bottom of the spectrum and 5 rows
   at the top are all averaged together and the average subtracted from
   all rows.  The "sky" rows are [8-12 + 24-28] (1-relative) for the PRISM
   and [5-9 + 28-32] for the GRISM.  If the -dSky option is specified,
   the rows at the bottom of the image are shifted down dSkyValue pixels
   and those at the top shifted up dSkyValue pixels.  I.e. a positive
   value of dSkyValue moves the sky estimation regions farther from the
   target spectrum.  If any of the sky estimation rows is moved off the
   detector window region, no onslit subtraction is done.  In other words
   specifying -dSky 50 will suppress all onslit subtraction.


oirChopPhotoImages.c

   new routine added mostly for MIA usage:  This performs the first
   step in oirChopPhotometry.c of averaging separately the SKY and 
   TARGET frames together for the AOPEN and BOPEN photometric
   exposures and producing a file with these images, as
   well as estimates of the pixel by pixel rms.  

oirMakePhotoSpectra.c

   new routine added mostly for MIA usage:  This performs the second
   step in oirChopPhotometry.c  It reads in the output of
   oirChopPhotoImages and performs various arithmetic and geometric
   means of the AOPEN and BOPEN images, with and without masking.
   The output of oirChopPhotoImages + oirMakePhotoSpectra should
   be the same as oirChopPhotometry.

oirRotateGroupDelay.c

   added test for time = NaN in data records.  These are invalid
   records that have been passed through the system so far in
   order not to disturb scan sequences.

midiUtilities.pro

   modified midiPipe so that it can make use of the utilities above.

   The dSky=dSkyValue option is translated into a value of dSky for 
      oirChopPhotometry

   The /filter option invokes the -no20 filter option in oirFormFringes

   The /fudge  option invokes the -fixopd option in oirFormFringes

   The /dAve   option invokes the -removeAverage option in oirFormFringes

   midiVisPipe performs the same functions and has the same arguments as
   midiPipe, but only does the reduction of the interferometric data;
   photometric reduction is skipped.  
   
   NOTE a small change for my convenience:  the syntax for midiPipe is

   midiPipe, tag, files=myfiles....

   but:

   midiVisPipe, tag, myfiles...     The files= keyword is not used.


There are other changes to midiPipe/midiVisPipe that invoke options
that are experimental and undocumented.  These are also not documented here.

ews_userguide.html

   Updated to cover most of the above changes.


wj: 20/01/2006:

   oirAutoFlag.c

   changed parameter syntax to -maxopd maxOpd -minopd minOpd -jump jumpOpd -side sideDrop
   added parameter minopd; if |trackopd-trueopd| < minopd, frame is flagged

   dispVis

   if removeAverage is specified in oirFormFringes, then -minopd 15 microns is automatically
   specified in oirAutoFlag in order to remove data at OPD zero crossings (where the
   signal has been removed by the removeAverage option).

wj: 3/02/2006:

   midiUtilities.c

   added midiPutDelay to facilitate storing an edited delay structure (output of
      oirGroupDelay)

   $oir/setup.pro

   added compilation of oirDelay.pro to setup

wj: 16/03/2006:

   midiUtilities.c

      added dAve option to midiSearch
      added better midiDelayAmpPlot1 routine to plot results of midiSearch

   dispSearch

      added dAve (removeAverage) option

   oirGroupDelay.c

      in Search mode: do not reset averaging buffer when FFT zero-point is shifted.
      This reduces signal near shifts, but alternative (reset averaging) increases
      noise near shift, which makes results difficult to interpret

wj: 10/05/2006

    ah--  too many things to record individually.  
       Usage() subroutines added to (almost) all oir routines, so they now type
       their syntax if you call them with no arguements

       More standardized printout from oir routines; they print their names before
       they do anything.

       oirChopPhotoImages is now used as the first step in all reduction of
       chopped photometric data.  So "unChop" has disappeared from a lot of
       oir programes.  oirChopPhotoImages works on only one input exposure
       at a time, so you have to run it multiple times to reduce AOPEN, BOPEN....

       Many changes to accommodate SCI_PHOT mode:
       oirCrossCoeff to calculate kappa coefficients between photometric and interferometric
          channels
       oirHi2SciPhot to resample and rescale photometric channels so they look like
          interferometric channels (and can be further reduced using oirMakePhotoSpectra).
       oirRescaleSpectra to take a "standard" photometry spectrum of a source and
          rescale it (constant plus linear w/ pixel terms) to look like an
          individual spectrum taken with the photometric channels

       dispSciPhot, dispSciPhotPhot and midiSPipe added to handle these programs at
          a higher level

       in midiCalibrate, the noPoint option has been removed (seemed pointless anyway) and
          replaced by /noPhot option.  This calculates calibrated correlated fluxes directly 
          from raw correlated ADUs (source/calibrator) without using photometric fluxes, 
          in case these are of poor quality.

wj: 28/06/2006:  
       in oirCalibrateVis.c, create new output file tag.calcorr.fits containing calibrated
       correlated fluxes in Jy rather than visibilities (thus not IAU IWG standard, but useful anyways),
       in the same format as tag.corr.fits for the uncalibrated correlated fluxes in ADU/s.
wj: 29/06/2006:  
       in oirWavelength.pro; call ::cleanup in underlying FITSTABLE object to release
       heap memory

       in oirCalibrateVis.c, implement -nophot option that specifies whether good photometry/poor photometry
       options are used in calculating calibrated correlated fluxes

       in midiUtilities.pro in midiCalibrate routine, implement /noPhot option that passes this parameter on
       to oirCalibrateVis

       update userguide for above changes
