knitr::opts_chunk$set( collapse = TRUE, comment = "#>", fig.width = 6, fig.height = 4, fig.align = "center" )
This vignette provides a conceptual overview of the statistical methods implemented in valytics. The goal is to help you understand what the numbers mean and how to think about them, not to prescribe specific acceptance criteria or make decisions for you.
Whether your analysis "passes" or "fails" depends entirely on your specific application, regulatory requirements, and clinical context. This package provides the tools; you and your organization define what constitutes acceptable agreement.
library(valytics) library(ggplot2)
The bias (mean difference) quantifies the average systematic offset between two methods. It answers: "On average, how much higher or lower does method Y read compared to method X?"
data("creatinine_serum") ba <- ba_analysis( x = creatinine_serum$enzymatic, y = creatinine_serum$jaffe )
cat("Bias:", round(ba$results$bias, 3), "mg/dL\n") cat("95% CI:", round(ba$results$bias_ci["lower"], 3), "to", round(ba$results$bias_ci["upper"], 3), "\n")
What this tells you:
What this does NOT tell you:
The limits of agreement (LoA) define an interval expected to contain 95% of the differences between methods. They answer: "For a randomly selected sample, how much could the two methods disagree?"
cat("Lower LoA:", round(ba$results$loa_lower, 3), "\n") cat("Upper LoA:", round(ba$results$loa_upper, 3), "\n") cat("Width:", round(ba$results$loa_upper - ba$results$loa_lower, 3), "\n")
The LoA represent the range of disagreement you can expect in practice. A narrow LoA indicates consistent agreement; a wide LoA indicates variable differences.
Key insight: The LoA are often more informative than the bias alone. Two methods might have negligible average bias but wide limits of agreement, meaning individual measurements could differ substantially.
The Bland-Altman plot provides a visual assessment:
plot(ba)
What to look for:
Bland-Altman analysis assumes normally distributed differences. The summary provides a Shapiro-Wilk test:
summ <- summary(ba) if (!is.null(summ$normality_test)) { cat("Shapiro-Wilk p-value:", round(summ$normality_test$p.value, 4), "\n") }
A low p-value suggests non-normality. Consider:
ggplot(data.frame(diff = ba$results$differences), aes(x = diff)) + geom_histogram(aes(y = after_stat(density)), bins = 15, fill = "steelblue", alpha = 0.7) + geom_density(linewidth = 1) + labs(x = "Difference (Jaffe - Enzymatic)", y = "Density") + theme_minimal()
Passing-Bablok regression fits a line: Y = intercept + slope * X
The parameters have direct interpretations:
pb <- pb_regression( x = creatinine_serum$enzymatic, y = creatinine_serum$jaffe )
cat("Slope:", round(pb$results$slope, 4), "\n") cat(" 95% CI:", round(pb$results$slope_ci["lower"], 4), "to", round(pb$results$slope_ci["upper"], 4), "\n") cat("Intercept:", round(pb$results$intercept, 4), "\n") cat(" 95% CI:", round(pb$results$intercept_ci["lower"], 4), "to", round(pb$results$intercept_ci["upper"], 4), "\n")
How to read the confidence intervals:
You can use the regression equation to estimate expected differences at specific concentrations:
# At various concentrations, what's the expected difference? concentrations <- c(0.8, 1.3, 3.0, 6.0) for (conc in concentrations) { expected_y <- pb$results$intercept + pb$results$slope * conc difference <- expected_y - conc cat(sprintf("At X = %.1f: expected Y = %.3f, difference = %.3f\n", conc, expected_y, difference)) }
This helps translate abstract regression parameters into concrete, application-specific terms.
The CUSUM test evaluates whether a linear model is appropriate:
cat("CUSUM statistic:", round(pb$cusum$statistic, 4), "\n") cat("p-value:", round(pb$cusum$p_value, 4), "\n")
A significant result (conventionally p \< 0.05) suggests the relationship may not be linear across the measurement range. If non-linearity is detected:
plot(pb, type = "cusum")
High correlation between methods is often reported but can be misleading:
r <- cor(creatinine_serum$enzymatic, creatinine_serum$jaffe) cat("Correlation coefficient:", round(r, 4), "\n")
Correlation measures whether methods rank samples similarly, not whether they give the same values. Two methods with r = 1 but different calibrations would show systematic bias that correlation fails to detect.
Your results depend on:
Be cautious about extrapolating beyond the conditions of your study.
A statistically significant bias (CI excludes zero) may or may not be practically important. Consider:
# Example: Is a bias of X clinically meaningful? # This depends entirely on YOUR application bias_value <- ba$results$bias cat("Observed bias:", round(bias_value, 3), "mg/dL\n") cat("\nWhether this is 'acceptable' depends on:\n") cat("- Your specific clinical decision thresholds\n") cat("- Regulatory requirements for your application\n") cat("- Intended use of the measurement\n") cat("- Established performance goals (CLIA, biological variation, etc.)\n")
Here's how to extract key statistics for reporting:
# Bland-Altman summary cat("=== Bland-Altman Analysis ===\n") cat(sprintf("n = %d\n", ba$input$n)) cat(sprintf("Bias: %.3f (95%% CI: %.3f to %.3f)\n", ba$results$bias, ba$results$bias_ci["lower"], ba$results$bias_ci["upper"])) cat(sprintf("SD of differences: %.3f\n", ba$results$sd_diff)) cat(sprintf("LoA: %.3f to %.3f\n\n", ba$results$loa_lower, ba$results$loa_upper)) # Passing-Bablok summary cat("=== Passing-Bablok Regression ===\n") cat(sprintf("Slope: %.4f (95%% CI: %.4f to %.4f)\n", pb$results$slope, pb$results$slope_ci["lower"], pb$results$slope_ci["upper"])) cat(sprintf("Intercept: %.4f (95%% CI: %.4f to %.4f)\n", pb$results$intercept, pb$results$intercept_ci["lower"], pb$results$intercept_ci["upper"])) cat(sprintf("CUSUM p-value: %.4f\n", pb$cusum$p_value))
The valytics package provides three complementary approaches for method comparison. Each has strengths suited to different scenarios.
comparison_df <- data.frame( Aspect = c( "Primary question", "Statistical approach", "Error assumption", "Outlier handling", "Output focus", "Sample size", "Best when" ), `Bland-Altman` = c( "How well do methods agree?", "Descriptive statistics", "Differences ~ Normal", "Sensitive", "Bias, limits of agreement", "n >= 30 recommended", "Defining acceptable agreement" ), `Passing-Bablok` = c( "Is there systematic bias?", "Non-parametric regression", "Distribution-free", "Robust", "Slope, intercept CIs", "n >= 30 for stable CIs", "Outliers present, unknown error" ), Deming = c( "Is there systematic bias?", "Parametric regression", "Errors ~ Normal", "Sensitive", "Slope, intercept, SEs", "n >= 10 feasible", "Known error ratio, small n" ), check.names = FALSE ) knitr::kable(comparison_df, caption = "Comparison of method comparison approaches")
In practice, using multiple methods provides a more complete picture:
# Complete method comparison workflow ba <- ba_analysis(reference ~ test, data = mydata) pb <- pb_regression(reference ~ test, data = mydata) dm <- deming_regression(reference ~ test, data = mydata) # Bland-Altman for agreement assessment summary(ba) plot(ba) # Compare regression methods cat("Passing-Bablok slope:", pb$results$slope, "\n") cat("Deming slope:", dm$results$slope, "\n")
If Passing-Bablok and Deming give similar results, you can be more confident in the conclusions. If they differ substantially, investigate why (outliers? non-normality? heteroscedasticity?).
The valytics package provides statistical tools for method comparison. It calculates:
These statistics describe the relationship between methods. Whether that relationship is "acceptable" for your purpose is a separate question that depends on:
The package reports what the data show. You decide what it means for your application.
Bland JM, Altman DG. Statistical methods for assessing agreement between two methods of clinical measurement. Lancet. 1986;1(8476):307-310.
Bland JM, Altman DG. Measuring agreement in method comparison studies. Statistical Methods in Medical Research. 1999;8(2):135-160.
Passing H, Bablok W. A new biometrical procedure for testing the equality of measurements from two different analytical methods. Journal of Clinical Chemistry and Clinical Biochemistry. 1983;21(11):709-720.
Westgard JO, Hunt MR. Use and interpretation of common statistical tests in method-comparison studies. Clinical Chemistry. 1973;19(1):49-57.
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.