Forensic Pedigree Analysis and Relatedness Inference
Overview
Forensic applications of pedigree analysis, including likelihood ratios for relationship testing, general relatedness inference, marker simulation, and power analysis. 'forrel' is part of the 'pedsuite', a collection of packages for pedigree analysis, further described in the book 'Pedigree Analysis in R' (Vigeland, 2021, ISBN:9780128244302). Several functions deal specifically with power analysis in missing person cases, implementing methods described in Vigeland et al. (2020) doi:10.1016/j.fsigen.2020.102376. Methods for checking pairwise relationships are described in Egeland and Vigeland (2025) doi:10.1016/j.fsigen.2025.103270. Data exchange with the 'Familias' software (Egeland et al. (2000) doi:10.1016/S0379-0738(00)00147-X) is supported through the 'pedFamilias' package.
- New function
LRpowerPlot()for visualising simulated LR distributions under two competing hypotheses. LRpower()andexclusionPower()(and the newLRpowerPlot()) now accept a named list of frequency vectors asmarkers, similarly toprofileSim().- For unlinked markers,
kinshipLR()now also returnslnLRtotalandlnLRperMarker. Similarly the output ofLRpower()now includeslog10LRperSim. These reduce the risk of numerical overflow and underflow. powerPlot()has been renamed toMPpowerPlot(), to avoid confusion with the newLRpowerPlot()and to reflect its connection with missing person (MP) applications. The old name is retained with a message for backwards compatibility.missingPersonIP()has a new argumenttrue, taking values"missing"(default, corresponding to the previous behaviour) or"unrelated", for simulating LR distributions under either hypothesis.expectedLR()no longer requires the input pedigree hypotheses to be connected.- For X-chromosomal markers,
expectedLR()now checks that the target individuals have the same sex in all hypotheses. - The re-exported
showInTriangle()has been removed; useribd::showInTriangle()directly.
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK14 OK2026-03-10
Documentation
- Help pages
- 29 (1 internal)includes a package overview page
- Examples that run
- 100%27 run in a plain check (1 of them under a condition)
- Exported functions with examples
- 100%
- Documented parameters
- 91%
- Return-value docs
- 100%
- Help pages citing references
- 21%
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- 2
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Releases over time
Issues over time
Commits over time
4 development-tooling and community-health practices detected across 4 families in the upstream repository
Checks run against github.com/magnusdv/forrel on 2026-10-18.
Dependencies
Installing forrel adds 17 packages (7 with compiled code, 3.9 MB of source tarballs). Heaviest: nanonext 911 KB, kinship2 484 KB, knitr 479 KB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 1.10.0Latest2026-10-06 · current release · diff ↗ ·
removed 1 export
showInTriangleadded 2 exports
LRpowerPlot, MPpowerPlot - 1.9.0
- RR 4.6.0 released · 2026-04-24
- 1.8.12025-07-21 · diff ↗
- 1.8.0
- RR 4.5.0 released · 2025-04-11
- 1.7.1
- 1.7.02024-09-04 · diff ↗ ·
removed 5 exports
Familias2ped, IBDtriangle, openFamilias, readFamiliasLoci, writeFamadded 4 exports
ibdLoglik, ibdLoglikFUN, plotCP, quickLR - RR 4.4.0 released · 2024-04-24
- 1.6.1
- 1.6.0
- 1.5.22023-05-23 · diff ↗
- RR 4.3.0 released · 2023-04-21
- 1.5.12023-04-14 · diff ↗
- 1.5.02023-02-28 · diff ↗
- RR 4.2.0 released · 2022-04-22
Show 9 earlier eventsHide 9 earlier events
- 1.4.1
- RR 4.1.0 released · 2021-05-18
- 1.3.02021-03-14 · diff ↗ ·
removed 4 exports
IBDestimate, deltaBootstrap, ibdEstim, kappaBootstrapadded 2 exports
ibdBootstrap, ibdEstimate - 1.2.0
- 1.1.02020-11-13 · diff ↗ ·
added 5 exports
checkPairwise, ibdEstim, markerSimParametric, missingPersonLR, profileSimParametric - RR 4.0.0 released · 2020-04-24
- 1.0.1
- 1.0.02020-01-30
- RR 3.6.0 released · 2019-04-26
Package metadata
- First published
- 2020-01-30
- Total releases
- 17 / 6 yrs
- License
- GPL (>= 2) OSI
- Minimum R
- ≥ 4.2.0
- Bundled data
- 62 KB / 3 files
- Download size
- 239 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("forrel")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-20, which the citation names so these numbers can be found later. More on citing and the projects behind them.