regdiff(7)							SAORD Documentation							regdiff(7)

NAME

       RegDiff - Differences Between Funtools and IRAF Regions

SYNOPSIS

       Describes the differences between Funtools/ds9 regions and the old IRAF/PROS regions.

DESCRIPTION

       We have tried to make Funtools regions compatible with their predecessor, IRAF/PROS regions. For simple regions and simple boolean algebra
       between regions, there should be no difference between the two implementations.	The following is a list of differences and incompatibili-
       ties between the two:

       o   If a pixel is covered by two different regions expressions, Funtools assigns the mask value of the first region that contains that
	   pixel.  That is, successive regions do not overwrite previous regions in the mask, as was the case with the original PROS regions.
	   This means that one must define overlapping regions in the reverse order in which they were defined in PROS.  If region N is fully con-
	   tained within region M, then N should be defined before M, or else it will be "covered up" by the latter. This change is necessitated
	   by the use of optimized filter compilation, i.e., Funtools only tests individual regions until a proper match is made.

       o   The PANDA region has replaced the old PROS syntax in which a PIE accelerator was combined with an ANNULUS accelerator using AND. That
	   is,

	     ANNULUS(20,20,0,15,n=4) & PIE(20,20,0,360,n=3)

	   has been replaced by:

	     PANDA(20,20,0,360,3,0,15,4)

	   The PROS syntax was inconsistent with the meaning of the AND operator.

       o   The meaning of pure numbers (i.e., without format specifiers) in regions has been clarified, as has the syntax for specifying coordi-
	   nate systems. See the general discussion on Spatial Region Filtering for more information.

SEE ALSO

       See funtools(7) for a list of Funtools help pages

version 1.4.2							  January 2, 2008							regdiff(7)