Changeset 25027 for branches/pap/extsrc/gpcsw/gpcsrc/fits/burntool/man/burntool.1

Timestamp:

Aug 7, 2009, 4:08:25 PM (17 years ago)

Author:

Paul Price

Message:

Merging trunk (r25026) to get up-to-date on old branch.

Location:

branches/pap

Files:

• . (modified) (1 prop)
• extsrc/gpcsw (modified) (1 prop)
• extsrc/gpcsw/gpcsrc/fits/burntool/man/burntool.1 (modified) (3 diffs)

branches/pap/extsrc/gpcsw

@@ -5 +5 @@
 man
 Makefile
+Makefile.bak

@@ -5 +5 @@
 man
 Makefile
+Makefile.bak

branches/pap/extsrc/gpcsw/gpcsrc/fits/burntool/man/burntool.1

@@ -66 +66 @@
         inhibited from subtracting the fits by "update=f".
         
+        Two other modes can be invoked using "tableonly=t" and "apply=t".
+        The first mode is just like "update=t", except that it does not write
+        the modified images, only the FITS table and/or tabulated fit data.
+        The second mode is like "restore=t", except that it subtracts the
+        tabulated fits instead of adding them back in.  Note that this requires
+        slightly different specifications for the "in=" file:
+
+                update or tableonly:    in=previous_file_for_persistence
+                restore or apply:       in=this_file_for_burn_and_persistence
+
+        Thus a sequence of images could be processed (leaving off usual
+        arguments such as mask=, etc) to immediately fit and subtract:
+
+           burntool o4991g0001o24.fits \
+                                   out=o4991g0001o24.burn \
+             psfstat=o4991g0001o24.stat psf=o4991g0001o24.psf
+
+           burntool o4991g0002o24.fits \
+             in=o4991g0001o24.burn out=o4991g0002o24.burn \
+             psfstat=o4991g0002o24.stat psf=o4991g0002o24.psf
+
+           burntool o4991g0003o24.fits \
+             in=o4991g0002o24.burn out=o4991g0003o24.burn \
+             psfstat=o4991g0003o24.stat psf=o4991g0003o24.psf
+
+        or as a two step process of generating tables:
+
+           burntool o4991g0001o24.fits tableonly=t \
+                                   out=o4991g0001o24.burn \
+             psfstat=o4991g0001o24.stat psf=o4991g0001o24.psf
+
+           burntool o4991g0002o24.fits tableonly=t \
+             in=o4991g0001o24.burn out=o4991g0002o24.burn \
+             psfstat=o4991g0002o24.stat psf=o4991g0002o24.psf
+
+           burntool o4991g0003o24.fits tableonly=t \
+             in=o4991g0002o24.burn out=o4991g0003o24.burn \
+             psfstat=o4991g0003o24.stat psf=o4991g0003o24.psf
+
+        and then later on carrying out the subtractions of the fits:
+
+           burntool o4991g0001o24.fits apply=t
+           burntool o4991g0002o24.fits apply=t
+           burntool o4991g0003o24.fits apply=t
+
         The identification of significant (but unsaturated) stars is an
         important component of burntool's mask generation, and if requested
         burntool can assemble a gallery of postage stamps of suitable stars.
+        This does not work with "restore=t" or "apply=t" of course, since
+        these work only on previous tables and do not examine the images.
         
         Any star whose maximum exceeds PSF_THRESH above sky but is not deemed
@@ -125 +172 @@
            qt=-5.201       Tangential quadrupole [pix^2] (-99.99 if fails)
                                 q+ * cos(2*phi) + qx * sin(2*phi)
+           q3c=-1.193      Cosine trefoil measure [pix^2] (-99.99 if fails)
+           q3s=-0.038      Sine trefoil measure [pix^2] (-99.99 if fails)
            qpm=5.154       Plus quadrupole averaged over psfavg
            qcm=0.560       Cross quadrupole averaged over psfavg
            qtm=-5.201      Tangential averaged over psfavg
+           q3cm=-1.230     Cosine trefoil averaged over psfavg
+           q3sm=-0.079     Sine trefoil averaged over psfavg
+
+        The net, polar coordinate quadrupole can be assembled from
+
+           Qmagnitude = sqrt(qpm^2+qcm^2)
+           Qtheta     = 0.5 * atan2(qcm, qpm)
 
         Helpful utilities include:
@@ -151 +207 @@
 
         update={t|f}   
-                Modify the input MEF by subtracting fits (default t)?
+                Calculate fits and modify the input MEF images by subtracting 
+                the trail fits and writing a FITS table (default t).  If
+                false the MEF is not altered, although PSF can be calculated.
 
         restore={t|f}  
-                Restore the input MEF by adding input fits (default f)?
+                Restore the input MEF by adding input fits (default f)
+
+        apply={t|f}
+                Use previously calculated fits to modify the input MEF image
+                by subtraction (default f)
+
+        tableonly={t|f}
+                Calculate fits but do *not* modify the input MEF images, 
+                only write the fit data as a FITS and/or text table (default f)
 
         in=fname       

@@ -5 +5 @@
 man
 Makefile
+Makefile.bak