FullCIs.MD: Confidence Intervals by CBLS with all potential solutions

Description Usage Arguments Details Value Author(s) References See Also Examples

View source: R/FullCIs.MD.R

Description

Estimate the Correlated-Bivariate-Least Square regression (CBLS) for all potential solutions from ρMD=-1 to ρMD=1, in a (M,D) plot. This function is analogous to FullCIs.XY estimating all the BLS regressions from OLSv to OLSh in a (X,Y) plot.

Usage

1
2
FullCIs.MD(data = NULL, xcol = 1, ycol = 2,
           conf.level = 0.95, npoints = 1000, nlambdas = 13)

Arguments

data

a data set (data frame or matrix).

xcol

a numeric vector to specify the X column(s) or a character vector with the column names.

ycol

a numeric vector to specify the Y column(s) or a character vector with the column names.

conf.level

a numeric value for the confidence level (expressed between 0 and 1).

npoints

an integer (at least 10) for the number of points to smooth the hyperbolic curves.

nlambdas

an integer for the number of intermediate CBLS regressions (the two extreme CBLS are calculated by default).

Details

The data argument is mandatory. This function is especially useful for unreplicated data with unknown ρMD (related to λXY, the ratio of the measurement error variances), as it calculates all the potential solutions. The different estimated regression lines are provided with the different confidence intervals.

Value

A CIs.MD class object, a list including the following elements:

Data.means

a table with the X and Y data (means of the replicated data if replicated), their means and differences.

Ellipses.CB

an array of dimension [npoints, 2 (intercept and slope), nlambdas + 2] with the coordinates of all the joint confidence intervals (confidence region, ellipses) from ρMD = -1 to ρMD = 1.

Slopes

a table (nlambdas + 2 rows) with all the slopes estimates and their approximate confidence intervals and pvalue (slope = 0).

Intercepts

a table (nlambdas + 2 rows) with all the intercepts estimates and their approximate confidence intervals and pvalue (intercept = 0).

Joints

a table (nlambdas + 2 rows) with all the pvalues of the joint hypothesis (slope = 0 and intercept = 0).

Hyperbolic.intervals

an array of dimension [npoints, 6 (X values, Y predictions, confidence interval and confidence bands), nlambdas + 2] with the hyperbolic confidence interval and confidence bands.

Author(s)

Bernard G FRANCQ

References

Francq BG, Govaerts BB. How to regress and predict in a Bland-Altman plot? Review and contribution based on tolerance intervals and correlated-errors-in-variables models. Statistics in Medicine, 2016; 35:2328-2358.

See Also

FullCIs.XY, CBLS

Examples

1
2
3

BivRegBLS documentation built on Oct. 11, 2019, 1:05 a.m.