Changeset 27839 for branches/simmosaic_branches/extsrc/gpcsw/gpcsrc/fits/burntool/man/burntool.1

Timestamp:

May 3, 2010, 8:45:22 AM (16 years ago)

Author:

eugene

Message:

updates from trunk

Location:

branches/simmosaic_branches

Files:

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

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

@@ -53 +53 @@
         power laws; downward burns as exponentials.
         
+        The fit to downward, persistence burns may have an unreasonable "slope"
+        (meaning exponential sign), increasing away from the burn origin.
+        These are discarded unless "persist=t" is invoked.  It is possible
+        for the fit to be fooled by uncataloged stars, so the persistence
+        can be kept in the output file with "persist=t" (although no fit
+        correction is applied) and they will propagate from input to output
+        until they finally achieve a legal fit with negligible amplitude.
+        Note that if burntool decides that a fit had a bad slope but was 
+        non-negligible it writes a function type "BURN_POSSLOPE" = 4 so
+        the box is available for masking if desired, and can be refitted
+        on subsequent images.
+
         Burntool also identifies really blasted areas which are saturated from
         top to bottom.  These cannot be fitted, but are carried along for
@@ -219 +231 @@
 
         tableonly={t|f}
-                Calculate fits but do *not* modify the input MEF images, 
+                Calculate fits but do *not* modify the input MEF pixels, 
                 only write the fit data as a FITS and/or text table (default f)
 
@@ -231 +243 @@
                 'in' takes precedence.
 
+        persist={t|f}
+                Retain persistence streaks whose fit slope turned out to be
+                unreasonable.
+
         out=fname      
                 Output file for burn streaks
@@ -290 +306 @@
         expire=N
                 Retire a blasted burn after N seconds
+
+        EADU=x
+                Set the minimum e/ADU for acceptable cell sky noise 
+                (default 0.3).  Should not normally be changed!
+        RN=x
+                Set the maximum read noise for acceptable cell sky noise 
+                (default 20).  Should not normally be changed!
+
+                Any cell whose noise variance in the sky is greater than
+                  sky/EADU+RN*RN  is rejected out of hand, and skipped for
+                further processing.
 
         quiet={t|f}    
@@ -332 +359 @@
 BUGS:
         090224: Still in development
+        090810: Squished a few memory bugs
 
 SEE ALSO: