Index: /trunk/psphot/doc/outline.txt
===================================================================
--- /trunk/psphot/doc/outline.txt	(revision 10053)
+++ /trunk/psphot/doc/outline.txt	(revision 10053)
@@ -0,0 +1,21 @@
+
+Here is a summary outline of the steps taken by psphotReadout:
+
+* setup (choose recipe, choose readout, define break-point)
+* create mask and weight images if needed, set mask for analysis region
+* psphotImageMedian : construct a background model image and subtract it
+* psphotFindPeaks   : smooth and find the peak pixels from the smoothed image
+  - no pmSource defined yet, only pmPeak
+* psphotSourceStats : create sources for each peak and measure their moments
+  - pmSource defined here, with pixels covering SKY_OUTER_RADIUS
+  - no pmModel is defined yet.
+* psphotBasicDeblend : identify blended sources by proximity and valley depth
+* psphotRoughClass : source classification guess based on moments
+  - set the source.type,mode.
+  - re-calculate moments for saturated stars
+* psphotChoosePSF : define the psf model
+  - this generates model fits to the identified psf stars
+    (one for each tested model)
+  - these models are not kept (seems like a waste, but later fits must be consistent)
+* psphotGuessModels : set the initial PSF model for each object (even EXTENDED)
+  - creates modelPSF entries
Index: /trunk/psphot/src/Makefile.am
===================================================================
--- /trunk/psphot/src/Makefile.am	(revision 10052)
+++ /trunk/psphot/src/Makefile.am	(revision 10053)
@@ -34,4 +34,5 @@
 	psphotBasicDeblend.c	\
 	psphotChoosePSF.c	\
+	psphotGuessModels.c     \
 	psphotEnsemblePSF.c	\
 	psphotBlendFit.c	\
Index: /trunk/psphot/src/psphot.h
===================================================================
--- /trunk/psphot/src/psphot.h	(revision 10052)
+++ /trunk/psphot/src/psphot.h	(revision 10053)
@@ -40,4 +40,5 @@
 bool            psphotMomentsStats (pmReadout *readout, psMetadata *recipe, psArray *sources);
 bool            psphotEnsemblePSF (pmReadout *readout, psArray *sources, psMetadata *recipe, pmPSF *psf, bool final);
+bool            psphotGuessModels (pmReadout *readout, psArray *sources, psMetadata *recipe, pmPSF *psf);
 bool            psphotBlendFit (pmReadout *readout, psArray *sources, psMetadata *recipe, pmPSF *psf);
 bool            psphotReplaceUnfit (psArray *sources);
Index: /trunk/psphot/src/psphotMaskReadout.c
===================================================================
--- /trunk/psphot/src/psphotMaskReadout.c	(revision 10052)
+++ /trunk/psphot/src/psphotMaskReadout.c	(revision 10053)
@@ -1,5 +1,4 @@
 # include "psphot.h"
 
-// 2006.02.04 : no leaks
 bool psphotMaskReadout (pmReadout *readout, psMetadata *recipe) {
     
@@ -16,6 +15,5 @@
     psRegion valid = psRegionSet (XMIN, XMAX, YMIN, YMAX);
 
-    // psRegionForImage creates a region for the subimage, not the parent
-    // XXX I propose that psRegionForImage treat the region as referring to the parent...
+    // restrict the supplied region above to the valid area on the image
     psRegion keep = psRegionForImage (readout->image, valid);
 
Index: /trunk/psphot/src/psphotRadiusChecks.c
===================================================================
--- /trunk/psphot/src/psphotRadiusChecks.c	(revision 10052)
+++ /trunk/psphot/src/psphotRadiusChecks.c	(revision 10053)
@@ -18,4 +18,5 @@
 }
 
+// call this function whenever you (re)-define the PSF model
 bool psphotCheckRadiusPSF (pmReadout *readout, pmSource *source, pmModel *model) {
 
@@ -68,4 +69,5 @@
 }
 
+// call this function whenever you (re)-define the EXT model
 bool psphotCheckRadiusEXT (pmReadout *readout, pmSource *source, pmModel *model) {
 
Index: /trunk/psphot/src/psphotRoughClass.c
===================================================================
--- /trunk/psphot/src/psphotRoughClass.c	(revision 10052)
+++ /trunk/psphot/src/psphotRoughClass.c	(revision 10053)
@@ -24,2 +24,3 @@
     return true;
 }
+
Index: /trunk/psphot/src/psphotSourceStats.c
===================================================================
--- /trunk/psphot/src/psphotSourceStats.c	(revision 10052)
+++ /trunk/psphot/src/psphotSourceStats.c	(revision 10053)
@@ -1,5 +1,4 @@
 # include "psphot.h"
 
-// 2006.02.02 : no leaks
 psArray *psphotSourceStats (pmReadout *readout, psMetadata *recipe, psArray *peaks)
 {