getRangeStat: Range statistics

View source: R/getRangeStat.R

getRangeStatR Documentation

Range statistics

Description

Returns range statistics: extreme spread, figure of merit, bounding box diagonal, each with corresponding confidence interval (CI). CI assumes a circular bivariate normal shot distribution with 0 mean, and all shots from the same group.

Usage

getRangeStat(xy, dstTarget, conversion, CIlevel=0.95)

## S3 method for class 'data.frame'
getRangeStat(xy, dstTarget, conversion, CIlevel=0.95)

## Default S3 method:
getRangeStat(xy, dstTarget, conversion, CIlevel=0.95)

Arguments

xy

either a numerical (n x p)-matrix with the coordinates of n points (1 row of p coordinates per point), or a data frame with either the variables x, y or point.x, point.y (optionally z or point.z).

dstTarget

a numerical value giving the distance to the target - used in MOA calculation. Acts as override if variable distance is already included in xy. See getMOA.

conversion

how to convert the measurement unit for distance to target to that of the (x,y)-coordinates in MOA calculation. Acts as override if variables dist.unit and point.unit are already included in xy. Example 'm2cm'. See getMOA.

CIlevel

a numerical value with the coverage for the confidence interval.

Details

Range stat CIs only available if data contains at most as many shots as tabulated in DFdistr.

Value

A named list with first component range_stat. This is a matrix with columns ES (extreme spread), FoM (figure of merit), D (bounding box diagonal). The second component CI gives the corresponding confidence interval boundaries as a named list with components ES, FoM, D.

References

Grubbs, F. E. (1964b). Statistical measures of accuracy for riflemen and missile engineers. Ann Arbor, ML: Edwards Brothers.

See Also

getMaxPairDist, getBoundingBox

Examples

getRangeStat(DFscar17)

dwoll/shotGroups documentation built on Oct. 17, 2024, 3:23 a.m.