%%% $Id: ChangeLogSDRS.tex,v 1.44 2006-10-25 01:48:17 price Exp $

\subsection{Changes from version 00 (16 August 2004) to version 01 (12 October 2004)}

\begin{itemize}
\item clarified the image offsets for pmFlatField ()
\item changed return value to bool.
\item added \code{pmCameraFromHeader}
\item added \code{pmCameraValidateHeaders}
\item added \code{pmFPAfromHeader}
\item Added \code{pmReadoutCombine}
\end{itemize}

\subsection{Changes from version 01 (12 October 2004) to version 02 (30 November 2004)}

\begin{itemize}
\item \code{nBin} in \code{pmSubtractBias} is also interpreted as the
  number of spline pieces if spline fitting is specified.
\item Refined \code{pmReadoutCombine} specification in response to bug 227.
\item added details to the functions \code{pmCameraFromHeader}, \code{pmCameraValidateHeaders}, and \code{pmFPAfromHeader}.  

\item reorganiztion: placed configuration section up front, camera layout next, etc
\item added details about configuration system
\item added utility modules \code{pmConfigLoadSite}, \code{pmConfigLoadCamera}, \code{pmConfigLoadRecipe}
\item added utility modules \code{pmConfigLookupSTR}, \code{pmConfigLookupS32}, \code{pmConfigLookupF64}, \code{pmConfigLookupRegion}, 
\item added discussion about Coordinate transforms
\item added discussion about \code{pmReadoutLoad}
\item added module \code{pmSubtractSky}
\end{itemize}

\subsection{Changes from version 02 (30 November 2004) to version 03 (21 January 2005) }

\begin{itemize}
\item Fixed up specification of \code{fitSpec} for \code{pmSubtractSky}.
\item Added a \code{mask} to \code{pmSubtractSky}, and specified that binned pixels which are clipped may be interpolated over, or simply ignored.
\item Added further explanation for \code{pmReadoutCombine}.
\item Added Object Detection section
\item Added PSPhot pseudo-C example
\end{itemize}

\subsection{Changes from version 03 (21 January 2005) to version 04 (14 February 2005)}

\begin{itemize}
\item changed entries of the form psXXX to pmXXX (object section)
\item added enum psSourceType
\item Specified appropriate image types for the phase 2 modules (bug 258).
\item clarified pmSourceRoughClass
\item clarified pmSourceAddModel, pmSourceSubModel
\end{itemize}

\subsection{Changes from version 04 (14 February 2005) to version 05 (21 March 2005)}

\begin{itemize}
\item Added section on image combination
\item Added section on image subtraction
\end{itemize}

\subsection{Changes from version 05 (21 March 2005) to version 06 (27 April 2005)}

\begin{itemize}
\item changed \code{pmFindImagePeaks} to return an array, not a list
\item replaced \code{pmCullPeaks} with \code{pmPeaksSubset} which returns a new array
\item changed \code{pmModel} to use vectors for params and dparms.
\item added nDOF and nIter to pmModel
\item changed models to return psF64, not psF32, to match psMinimizeLMChi2Func
\end{itemize}

\subsection{Changes from version 06 (27 April 2005) to version 07 (15 July 2005)}

\begin{itemize}
\item Changed \code{psRegion *region} to \code{psRegion region} in
  prototypes (passed by value instead of by reference).
\item \code{pmSourceMoments} does not require image parameter.
\item Added \code{masks} to \code{pmRejectPixels}.
\item Added \code{size} and \code{spatialOrder} to \code{pmSubtractionKernels}.
\item added Image Hierarchy section from psLibSDRS
\item added photometry section from psLibSDRS
\item added object function abstractions to Objects
\item modified pmSource to include modelPSF and modelFLT
\item Major changes to configuration.  Modifyied \code{pmConfig}
  functions, and \code{pmCameraFromHeader}, and added various other
  functions.
\item Modifying \code{psReadout, psCell, psChip, psFPA} structures.
\item Removing \code{psObservatory, psExposure, psGrommit} which were
  centered on slalib.
\item Added \code{pmFPAConstruct, pmFPARead, pmFPAMorph, pmFPAWrite}.
\end{itemize}

\subsection{Changes from version 07 (15 July 2005) to version 08 (13 Sept 2005)}

\begin{itemize}
\item Added \code{bias} sections to \code{pmReadout}.
\item Added \code{CELL.READDIR} to specify read direction; \code{pmCellGetReaddir}.
\item \code{pmFPAMorph} specified, ready for coding.
\item \code{pmConfigRead} shall call \code{psTimeInitialize}, \code{psLogSetLevel},
  \code{psLogSetFormat}, \code{psTraceSetLevel}.
\item Added \code{pmConfigDB}.
\item Changed \code{pmNonLinearityLookup} to read a \code{psLookupTable}.
\item Changed input types for \code{pmMaskBadPixels}.
\item Added \code{pmFPAWriteMask}.
\item \code{pmMaskBadPixels} shall grow the mask for saturated by 1, in addition
  to the explicit grow.
\item Added section on ``Paper Trail'' to Phase 2 functions.
\item Adding log destination to \code{pmConfigRead}.
\item Changing details of focal plane hierarchy.
\item Concepts are evaluated at ingest by \code{pmFPARead}.
\item Modified \code{pmSubtractBias}.
\item Remove mask from \code{pmFlatField} (mask is contained in the readout).

\item cleaned up / extended discussion of FITS and the FPA hierarchy.
\item added \code{CONCEPT.DEFAULT} to \code{DEFAULTS} table.
\item added \code{psArgumentVerbosity} requirement to \code{pmConfigRead}.

\item substantial changes to the Objects section:
\begin{itemize}
  \item added \code{psphotMaskValues}?
  \item added SN to \code{pmMoments}
  \item added \code{pmPSFClump}
  \item modified \code{pmSourceType} enum list
  \item added radius to \code{pmModel}
  \item added \code{pmModelGroup}
  \item added several Model Group functions
  \item added \code{pmPSF} and related functions
  \item added \code{pmPSFtry} and related functions
  \item added \code{pmSourceDefinePixels}
  \item modified \code{pmSourceLocalSky} API
  \item modified \code{pmSourceMoments} API
  \item added \code{pmSourcePSFClump}
  \item modified \code{pmSourceRoughClass} API
  \item dropped \code{pmSourceSetPixelsCircle} (replaced with
  \code{pmSourceDefinePixels} and the image mask functions.
  \item added \code{pmModelFitStatus}
  \item added \code{pmSourcePhotometry}
  \item added \code{pmSourceDophotType}
  \item added \code{pmSourceSextractType}
  \item moved discussion of the object models to an appendix
\end{itemize}
\end{itemize}

\subsection{Changes from version 08 (13 Sept 2005) to version 09 (18 Oct 2005)}

\begin{itemize}
  \item fix enum syntax
  \item added Astrometry Fitting Support (matching / fitting routines)
  \item added \code{pmAstromRadiusMatch}
  \item added \code{pmAstromGridMatch}
  \item added \code{pmAstromApplyGridMatch}
  \item added \code{pmAstromMeasureGradients}
  \item added \code{pmAstromFitFPA}
  \item added \code{pmAstromFitChip}
  \item added \code{pmAstromFitDistortion}
  \item renamed section 7 to Detrend Creation, moved \code{pmReadoutCombine} to a subsection
  \item added \code{pmFringeStats} (Fringe Amplitude subsection)
  \item added \code{pmFlatNormalization} (Flat-field renorm section)
  \item added \code{pmDetrendLookup}
\end{itemize}

\subsection{Changes from version 09 (18 Oct 2005) to version 10 (06 Dec 2005)}

\begin{itemize}
\item \code{pmSubtractBias}: The overscans are to be derived by the
  function using \code{CELL.BIASSEC} (not from the \code{bias}
  parameter passed to the function, which is supposed to hold the
  full-frame bias image).
\item \code{pmSubtractBias}: The full-frame (bias and dark)
  subtractions should only be performed on the region of the image
  specified by \code{CELL.TRIMSEC}.
\item \code{pmNonLinearityPolynomial}, \code{pmNonLinearityLookup},
  \code{pmFlatField}, \code{pmMaskBadPixels}, \code{pmSubtractSky} are
  to act only on the region of the readout image specified by
  \code{CELL.TRIMSEC}
\item Added \code{p_pmHDU}.
\item Changed \code{pmFPA,pmChip,pmCell->private} to \code{hdu}.

\item changed \code{pmAstrometryReadWCS} to \code{pmAstromReadWCS}
\item changed \code{pmAstrometryWriteWCS} to \code{pmAstromWriteWCS}
\item changed \code{pmAstromGridMatch} to output \code{pmAstromStats}
\item moved various \code{pmAstromGridMatch} output values from metadata 
to the output \code{pmAstromStats}
\item changed \code{pmAstromGridMatchAngle} to \code{pmAsromGridAngle}
\item changed \code{pmAstromGridAngle} to output \code{pmAstromStats}
\item changed \code{pmAstromRotateObj} to accept center as \code{psPlane}

\end{itemize}

\subsection{Changes from version 10 (06 Dec 2005) to version 11 (22 Jan 2006)}

\begin{itemize}
\item modification of bias subtraction API
\item updates to object/psphot APIs
\end{itemize}

\subsection{Changes from version 11 (22 Jan 2006) to present}

\begin{itemize}
\item clarified pmFindImagePeaks to use parent coordinates
\item Major changes to bring spec up to date with code.
\end{itemize}

