- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑
Description:
This routine writes the statistics of pixel data as generated by the routines
KPG1_STATx, KPG_OSTAx, and KPG1_HSTAx to a text file.
Invocation
CALL KPG1_STFLx( IWCS,
NDIM, EL, NGOOD, DMIN, MINP, MINC, DMAX, MAXP, MAXC, SUM, MEAN, STDEV, SKEW, KURTOS,
MEDIAN, MODE, NUMPER, PERCNT, PERVAL, IFIL, 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.
IFIL = INTEGER (Given)
FIO_ file descriptor for the
output file.
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 ↑