View source: R/groupLocation.R
groupLocation | R Documentation |
Calculates location measures for a single group of bullet holes.
groupLocation(xy, level = 0.95, plots = TRUE, bootCI = 'none',
dstTarget, conversion)
## S3 method for class 'data.frame'
groupLocation(xy, level = 0.95, plots = TRUE, bootCI = 'none',
dstTarget, conversion)
## Default S3 method:
groupLocation(xy, level = 0.95, plots = TRUE, bootCI = 'none',
dstTarget, conversion)
xy |
either a numerical (n x 2)-matrix with the (x,y)-coordinates of n points (1 row of coordinates per point), or a data frame with either the variables |
level |
a numerical value giving the level for the confidence intervals for the center (x,y)-coordinates. |
plots |
logical: show a 2D-scatterplot? |
bootCI |
a character vector to select which bootstrap confidence interval type to report. Possible types are |
dstTarget |
a numerical value giving the distance to the target - used in MOA calculation. Acts as override if variable |
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 |
The number of replicates for the reported bootstrap confidence intervals is at least 1499. If the BCa interval is reported, it is at least the number of points.
If package shiny
is installed, an interactive web app for this functionality can be run with runGUI("analyze")
.
A list with the results from the numerical analyses and statistical tests.
ctr |
(x,y)-offset of group center relative to point of aim. |
ctrXci |
parametric (t) and bootstrap confidence intervals for center x-coordinate. |
ctrYci |
parametric (t) and bootstrap confidence intervals for center y-coordinate. |
ctrRob |
robust estimate of group center offset relative to point of aim (MCD algorithm). |
distPOA |
distance from group center to point of aim (in original measurement units, MOA, SMOA, milliradian). |
distPOArob |
distance from robust estimate of group center to point of aim (in original measurement units, MOA, SMOA, milliradian). |
Hotelling |
Hotelling's T^2-Test result from testing if group center equals point of aim. |
getMOA
,
covMcd
,
anova.mlm
,
boot
,
boot.ci
# coordinates given by a suitable data frame
res <- groupLocation(DFsavage, dstTarget=100, conversion='m2mm',
level=0.95, plots=2, bootCI='basic')
names(res)
res$ctr
res$distPOA
res$ctrXci
res$ctrYci
# coordinates given by a matrix
## Not run:
# assume data from pistol shooting at 25m with 9mm ammo
# metric units
xy <- matrix(round(rnorm(100, 0, 5), 2), ncol=2)
groupLocation(xy, dstTarget=25, conversion='m2cm', plots=2)
## End(Not run)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.