reference_interval/
lib.rs

1//! # Reference interval Rust crate
2//!
3//! This create provides several ways to help with a reference interval:
4//!
5//! * `ReferenceInterval` - A simple struct to hold a reference interval with a units label.
6//!
7//! * `ReferenceIntervalWithSample` - A struct that decorates a `ReferenceInterval` with a random sample function.
8//!
9//! * `mean` - A helper function to calculate the mean of a reference interval.
10//!
11//! Wikipedia has an introduction to the concept of a reference interval, which we've excerpted and edited below.
12//!
13//! * <https://en.wikipedia.org/wiki/Reference_interval>
14//!
15//! ## Reference interval
16//!
17//! A reference interval is the set of values that are deemed normal for a
18//! measurement.
19//!
20//! A reference interval is a basis for comparison and interpretation, typically
21//! comparing and interpreting one measurement result with a general group of
22//! measurement results.
23//!
24//! Some important reference intervals are in medicine and health care. Examples are
25//! a reference interval for hemoglobin blood testing, a reference interval for
26//! cortisol hormone testing, a reference interval for histamine allergy testing,
27//! and a reference interval for acidity urine testing.
28//!
29//! ## Standard reference interval
30//!
31//! A standard reference interval is defined as the interval between which 95% of
32//! values of a reference population fall into, in such a way that 2.5% of the time
33//! a value will be less than the lower limit of this interval, and 2.5% of the time
34//! it will be larger than the upper limit of this interval, whatever the
35//! distribution of these values.
36//!
37//! ## General reference interval
38//!
39//! A general reference interval is defined as a standard reference interval based
40//! on what is most prevalent in a reference group taken from the general
41//! population, and without any known aspect that directly affects the interval
42//! being established.
43//!
44//! ## Subgroup reference interval
45//!
46//! A subgroup reference interval is defined as a standard reference interval based
47//! on a subgroup with a known aspect that directly affects the interval being
48//! established.
49//!
50//! ## Within Reference Interval (WRI)
51//!
52//! A value inside a reference interval is termed within reference interval (WRI).
53//!
54//! A value inside a reference interval is not necessarily good, and not necessarily
55//! normal in any sense other than statistically.
56//!
57//! ## Beyond reference interval (BRI)
58//!
59//! A value outside a reference interval is termed beyond reference interval (BRI).
60//!
61//! A value outside a reference interval is not necessarily bad, and not necessarily
62//! abnormal in any sense other than statistically.
63//!
64//! ## Lower Reference Limit (LRL) & Upper Reference Limit (URL)
65//!
66//! The limits are called:
67//!
68//! * The lower reference limit (LRL) a.k.a. lower limit of normal (LLN)
69//!
70//! * The upper reference limit (URL) a.k.a. upper limit of normal (ULN)
71//!
72//! For mass communications such as publishing, style sheets sometimes prefer the
73//! word "reference" over the word "normal", to prevent the nontechnical senses of
74//! normal from being conflated with the statistical sense.
75//!
76//! ## Binary classification
77//!
78//! For binary classification, a cutoff or threshold is a limit used mainly between
79//! within reference interval (WRI) and beyond reference interval (BRI).
80//!
81//! ## Reference interval vs. reference range
82//!
83//! A reference interval is a.k.a. reference range. Because mathematical statistics
84//! defines the term "range" as describing the interval between the smallest and
85//! largest values, many, including the International Federation of Clinical
86//! Chemistry prefer to use the expression reference interval rather than reference
87//! range.
88//!
89pub mod reference_interval;
90pub mod reference_interval_with_sample;
91pub mod mean;
92
93#[allow(unused_imports)] use reference_interval::ReferenceInterval;
94#[allow(unused_imports)] use reference_interval_with_sample::ReferenceIntervalWithSample;
95#[allow(unused_imports)] use mean::mean;