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 incompatibilities between the two:
- •
- 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 contained 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.
- •
- 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.
- •
- The meaning of pure numbers (i.e., without format specifiers) in regions
has been clarified, as has the syntax for specifying coordinate systems.
See the general discussion on Spatial Region Filtering for more
information.
SEE ALSO¶
See
funtools(7) for a list of Funtools help pages