- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑
Description:
This routine displays the statistics of pixel data as generated by the routines
KPG1_STATx, KPG_OSTAx, and KPG1_HSTAx.
Invocation
CALL KPG1_STDSx( IWCS, NDIM, EL,
NGOOD, DMIN, MINP, MINC, DMAX, MAXP, MAXC, SUM, MEAN, STDEV, SKEW, KURTOS, MEDIAN,
MODE, NUMPER, PERCNT, PERVAL, MAXWCS, MINWCS, STATUS )
Arguments
IWCS = INTEGER
(Given)
Pointer to WCS FrameSet.
NDIM = INTEGER (Given)
Number of dimensions of the array
whose statistics are being displayed.
EL = INTEGER (Given)
Total number of pixels in the
array.
NGOOD = INTEGER (Given)
Number of valid pixels which contributed to the
statistics.
DMIN = DOUBLE PRECISION (Given)
Minimum pixel value.
MINP( NDIM ) =
INTEGER (Given)
Pixel indices at which the minimum pixel value was (first) found.
MINC( NDIM ) = DOUBLE PRECISION (Given)
The co-ordinate values of the centre of
the minimum pixel.
DMAX = DOUBLE PRECISION (Given)
Maximum pixel value.
MAXP( NDIM ) = INTEGER (Given)
Pixel indices at which the maximum pixel value
was (first) found.
MAXC( NDIM ) = DOUBLE PRECISION (Given)
The co-ordinate
values of the centre of the maximum pixel.
SUM = DOUBLE PRECISION (Given)
Pixel
sum.
MEAN = DOUBLE PRECISION (Given)
Pixel mean value.
STDEV = DOUBLE
PRECISION (Given)
Pixel standard deviation value.
SKEW = DOUBLE PRECISION
(Given)
Skewness of the pixel values.
KURTOS = DOUBLE PRECISION (Given)
Pixel
kurtosis.
MEDIAN = DOUBLE PRECISION (Given)
Median value.
MODE = DOUBLE
PRECISION (Given)
Modal value.
NUMPER = INTEGER (Given)
Number of percentiles
values to report.
PERCNT( NUMPER ) = REAL (Given)
The array of percentiles levels
corresponding to the values given by PERVAL. They should be in the range 0.0 to 100.0, and
preferably in ascending order. If there are none to report, set NUMPER to 1 and pass the bad
value in PERCNT( 1 ).
PERVAL( NUMPER ) = DOUBLE PRECISION (Given)
Percentile
values corresponding to the percentile fractions in PERCNT.
MAXWCS = CHARACTER
(
)
(Returned)
The formatted WCS co-ordinates at the minimum position.
MINWCS = CHARACTER
(
)
(Returned)
The formatted WCS co-ordinates at the minimum position.
STATUS = INTEGER (Given
and Returned)
The global status.
Notes:
-
There is a routine for both real and double-precision statistics: replace " x" in the routine name
by R or D as appropriate. Note that the two routines have identical argument lists (with
floating-point qualitities in double precision) but differ in the precision with which the results are
displayed.
-
If the value of NGOOD is not positive, then this routine will assume that all the derived statistics
(except for the sum) are undefined and will not display them.
-
If a statistic is undefined, i.e. has the bad value, it is not reported. In the case of arrays, the first value is
checked. For the co-ordinates and pixel indices of the extreme values both of the first elements of these
must be good to display these positions.
- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑