Creates a radial or azimuthal profile of a two-dimensional image
The area of the input image which is to be binned is the annulus enclosed between the two concentric ellipses defined by Parameters 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 Parameter WIDTH. The number of bins is specified by NBIN.
[0.0]
[0.0]
ESTIMATOR = LITERAL (Read)
"Mean"
or "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.
["Mean"]
[!]
["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. [TRUE]
[1.0]
!
) 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. [!]
[0.0]
["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.0
is 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.
Processing of bad pixels and automatic quality masking are supported.
All non-complex numeric data types can be handled. Arithmetic is performed using single-precision floating point.