The area of the input image which is to be binned is the annulus enclosed between the two concentric ellipses defined by Parameter RATIO, ANGMAJ, RMIN and RMAX. The binned area can be restricted to an azimuthal section of this annulus using Parameter ANGLIM. Input data outside the area selected by these parameters is ignored. The selected area can be binned in two ways, specified by Parameter RADIAL.
If radial binning is selected (the default), then each bin is an elliptical annulus concentric with the ellipses bounding the binned area. The number of bins is specified by Parameter NBIN and the radial thickness of each bin is specified by WIDTH.
If azimuthal binning is selected, then each bin is a sector (i.e. a wedge-shape), with its vertex given by Parameters XC and YC, and its opening angle given by Parameters WIDTH. The number of bins is specified by NBIN.
ESTIMATOR = LITERAL (Read)
"Weighted Mean". If the weighted mean option is selected but no variances are available in the input data, the unweighted mean will be used instead.
["Mask created by KAPPA - Elprof"]
TRUE, then a radial profile is produced in which each bin is an elliptical annulus. Otherwise, an azimuthal profile is produced in which each bin is a wedge-shaped sector.
!) is supplied the value used is the distance from the ellipse centre (specified by XC and YC) to the furthest corner of the image. This will cause the entire image to fall within the outer edge of the binning area.
["KAPPA - Elprof"]
!) value is supplied, the value used is chosen so that there are no gaps between adjacent bins. Smaller values will result in gaps appearing between adjacent bins. The supplied value must be small enough to ensure that adjacent bins do not overlap. The supplied value must be at least 1.0.
"galaxy", containing 10 bins. Each bin will be a wedge-shaped sector with vertex at pixel co-ordinates (113,210). The clockwise edge of the first bin will be at an angle of 20 degrees to the x-axis, and each bin will have a width (opening angle) of 36 degrees (so that 360 degrees are covered in total). Only the section of each sector bounded by radii of 50 and 60 pixels is included in the profile. In this case the default value of
1.0is accepted for Parameter RATIO and so the bins will form a circular annulus of width 10 pixels.
This routine correctly processes the DATA, VARIANCE, TITLE, UNITS, WCS (in radial mode only) and HISTORY components of the input NDF to the output profile NDF. WCS information is also propagated to the output mask NDF.
WCS information is currently lost by this application.
All non-complex numeric data types can be handled. Arithmetic is performed using single-precision floating point.