From 0e44aa36a796c7f2952000f2df7d02bb249f4e9c Mon Sep 17 00:00:00 2001
From: Anil Tellbuescher <anil@tellbuescher.online>
Date: Sat, 11 Jan 2025 13:40:33 +0100
Subject: add example calibration data from DIN 38402

---
 man/linearity.Rd | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 man/linearity.Rd

(limited to 'man/linearity.Rd')

diff --git a/man/linearity.Rd b/man/linearity.Rd
new file mode 100644
index 0000000..aa3d857
--- /dev/null
+++ b/man/linearity.Rd
@@ -0,0 +1,62 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/linearity.R
+\name{linearity}
+\alias{linearity}
+\title{Assess the linearity of a calibration curve}
+\usage{
+linearity(x, y, method = c("slope", "curvature"), tolerance = 0.1)
+}
+\arguments{
+\item{x}{numeric vector of independent values (usually concentrations).}
+
+\item{y}{numeric vector of dependent values (usually the signal of the
+analytical device).}
+
+\item{method}{character string. Supported methods are "slope" and
+"curvature".}
+
+\item{tolerance}{numeric value between 0 and 1, describing the acceptable
+deviation from the median of the slopes or the signal-to-concentration
+ratio. The default tolerance is 10\%.}
+}
+\value{
+returns a diagnostic plot
+}
+\description{
+A function to create diagnostic plots for the assessment of the linearity of
+calibration data based on their point-to-point slope or the curvature.
+The underlying methods follow ISO 84 66-1:2021 and DIN 32 402-51:2017
+(German Industrial Norm).
+}
+\details{
+The point-to-point slope method is based on the assumption that the slope
+between two points should not vary greatly within the linear range.
+
+The curvature method is similar to the point-to-point slope method. Here,
+the ratio between the instrument signal and the concentration of the
+calibration standard is assumed not to vary greatly within the linear range.
+
+The use of the Mandel test is discouraged due to its limitations in the
+identification of non-linear behaviour of calibration curves (Andrade and
+Gomes-Carracedo, 2013).
+}
+\examples{
+data(din32645)
+# Point-to-point slope plot
+linearity(din32645$x, din32645$y, method = "slope")
+
+# Curvature plot
+linearity(din32645$x, din32645$y, method = "curvature", tolerance = 0.2)
+
+}
+\references{
+ISO 8466-1:2021. Water quality — Calibration and evaluation of
+analytical methods — Part 1: Linear calibration function
+
+J. M. Andrade and M. P. Gomez-Carracedo (2013) Notes on the use of
+Mandel's test to check for nonlinearity in laboratory calibrations.
+Analytical Methods 5(5), 1145 - 1149.
+}
+\author{
+Anil Axel Tellbüscher
+}
-- 
cgit v1.2.1


From c7b841c93dc2f3228dfe65ebd3bdd7a7f546fb96 Mon Sep 17 00:00:00 2001
From: Johannes Ranke <johannes.ranke@jrwb.de>
Date: Wed, 22 Jan 2025 17:14:04 +0100
Subject: Satisfy R CMD check

- Depend on R >= 3.5.0, because the format used for the data is not
  known to earlier R versions
- Rename the datasets from `test` to their proper name
---
 man/linearity.Rd | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

(limited to 'man/linearity.Rd')

diff --git a/man/linearity.Rd b/man/linearity.Rd
index aa3d857..52c2423 100644
--- a/man/linearity.Rd
+++ b/man/linearity.Rd
@@ -41,12 +41,14 @@ identification of non-linear behaviour of calibration curves (Andrade and
 Gomes-Carracedo, 2013).
 }
 \examples{
-data(din32645)
+# Continuous Flow Analysis (CFA) data
+data(din38402b1)
+
 # Point-to-point slope plot
-linearity(din32645$x, din32645$y, method = "slope")
+linearity(din38402b1$conc, din38402b1$ext, method = "slope")
 
 # Curvature plot
-linearity(din32645$x, din32645$y, method = "curvature", tolerance = 0.2)
+linearity(din38402b1$conc, din38402b1$ext, method = "curvature")
 
 }
 \references{
@@ -58,5 +60,5 @@ Mandel's test to check for nonlinearity in laboratory calibrations.
 Analytical Methods 5(5), 1145 - 1149.
 }
 \author{
-Anil Axel Tellbüscher
+Anıl Axel Tellbüscher
 }
-- 
cgit v1.2.1