Removal of Unwanted Technical Variation from UK Biobank NMR Metabolomics Biomarker Data
Overview
A suite of utilities for working with the UK Biobank https://www.ukbiobank.ac.uk/ Nuclear Magnetic Resonance spectroscopy (NMR) metabolomics data https://biobank.ndph.ox.ac.uk/showcase/label.cgi?id=220. Includes functions for extracting biomarkers from decoded UK Biobank field data, removing unwanted technical variation from biomarker concentrations, computing an extended set of lipid, fatty acid, and cholesterol fractions, and for re-deriving composite biomarkers and ratios after adjusting data for unwanted biological variation. For further details on methods see Ritchie SC et al. Sci Data (2023) doi:10.1038/s41597-023-01949-y.
- Added lipoprotein fatty acid contents to the extended set of biomarkers computed by the ukbnmr package based on the formula published by Belkadi *et al.* 2026 (doi: 10.1021/acs.jproteome.6c00107). These can be computed directly by the new compute_lipoprotein_fatty_acids() function, and are returned with the extended set of biomarkers computed by the recompute_derived_biomarkers() and remove_technical_variation() functions.
- Updated outdated documentation that referred to the tools used for legacy UK Biobank datasets for data extraction that are no longer relevant now that analyses must take place on the UK Biobank Research Analysis Platform.
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-04
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
- NOTE12 OK, 1 NOTE2026-06-08
- OK14 OK2026-04-14
Show 2 earlier changesHide 2 earlier changes
- NOTE13 OK, 1 NOTE2026-04-12
- OK14 OK2026-03-10
Documentation
- Help pages
- 14includes a package overview page
- Examples that run
- 100%10 run in a plain check
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 14%
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- 17
- Median days to close, 50 most recently updated closed PRs
- 12
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
1 development-tooling and community-health practice detected across 1 family in the upstream repository
Checks run against github.com/sritchie73/ukbnmr on 2026-10-11.
Dependencies
Installing ukbnmr adds 7 packages (5 with compiled code, 7.0 MB of source tarballs). Heaviest: data.table 5.7 MB, lubridate 420 KB, cpp11 298 KB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 3.4Latest2026-07-07 · current release · diff ↗ ·
added 2 exports
compute_lipoprotein_fatty_acids, compute_lipoprotein_fatty_acids_flags - RR 4.6.0 released · 2026-04-24
- 3.3.22026-04-12 · diff ↗
- 3.3.12025-11-30 · diff ↗
- 3.3.02025-11-28 · diff ↗
- RR 4.5.0 released · 2025-04-11
- 3.2.02024-11-14 · diff ↗ ·
removed 2 exports
compute_nightingale_ratio_qc_flags, compute_nightingale_ratios - RR 4.4.0 released · 2024-04-24
- 2.22023-08-23 · diff ↗
- 2.1.32023-08-21 · diff ↗
- RR 4.3.0 released · 2023-04-21
- 1.52023-01-31 · diff ↗
- 1.42023-01-09
- RR 4.2.0 released · 2022-04-22
Package metadata
- First published
- 2023-01-09
- Total releases
- 9 / 3 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 2.10
- Bundled data
- 12 KB / 3 files
- Download size
- 3.6 MB
Cite
Cite this package
Run in R for the authors' entry:
citation("ukbnmr")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.1038/s41597-023-01949-y, 10.1021/acs.jproteome.6c00107.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-19, which the citation names so these numbers can be found later. More on citing and the projects behind them.