R Observatory: Metrics for eq5d version 0.17.0

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

eq5d

0.17.0Package record

Methods for Analysing 'EQ-5D' Data and Calculating 'EQ-5D' Index Scores

0packages depend

15.7Kdownloads / year

94.9%test coverage

13/13flavors OK

Overview

About

Maintained by Fraser MortonCRAN page ↗GitHub ↗Issues ↗

EQ-5D is a widely used health-related quality-of-life instrument developed by the EuroQol Group and used in the clinical and economic evaluation of health care. Health is described using five dimensions (mobility, self-care, usual activities, pain/discomfort, and anxiety/depression) rated on either a three-level (EQ-5D-3L and EQ-5D-Y-3L) or five-level (EQ-5D-5L) scale. Responses can be reported as EQ-5D health states or converted to utility index scores using country-specific value sets. The package provides methods for the valuation, reporting and analysis of EQ-5D data. Utility index scores can be calculated for EQ-5D-3L, EQ-5D-5L and EQ-5D-Y-3L data using a wide range of value sets and mapping approaches. Functionality is also provided for descriptive-system reporting, severity and distributional summaries, informativity measures, health-state distribution analysis, longitudinal change analysis, probability of superiority analysis and Health Profile Grid visualisation. Methods described in Devlin et al. (2020) doi:10.1007/978-3-030-47622-9 are implemented where appropriate. A companion 'Shiny' application is included for interactive analysis and visualisation of EQ-5D datasets.

Changes in 0.17.0

Data and analytical infrastructure

Added descriptive_data(), providing a canonical, tidy representation of the EQ‑5D descriptive system for reuse across plots and tables.
Added table_descriptive(), a reporting helper for producing descriptive‑system tables of EQ‑5D response‑level distributions by dimension.
Added table_ps(), a reporting helper for formatting Probability of Superiority (PS) output into a tabular representation.

Visualisation

Added plot_descriptive() to visualise the EQ‑5D descriptive system using side‑by‑side bar charts, with optional faceting for grouped data.

Show all changes in 0.17.0Hide the rest of the changes in 0.17.0

Added plot_hsdc() to visualise Health State Density Curves (HSDC) from pre-computed cumulative distributions.
Added plot_severity_summary() to visualise EQ-5D index values across severity strata using the Level Frequency Score (LFS) or Level Sum Score (LSS).
Added plot_hpg() to visualise paired EQ-5D health state transitions using the Health Profile Grid, supporting optional exclusion of full-health transitions and publication-ready styling.

Documentation and reporting guidance

Added a set of reporting vignettes covering descriptive system reporting, severity and distributional summaries, and longitudinal change analysis.
Added an overview vignette describing the reporting workflows and reporting tools available in eq5d.

Internal refactoring and structural improvements

Internal implementations of LFS and LSS revised to ensure type-stable outputs.
Severity, informativity, and cumulative distribution components refactored to provide clearer, more consistent internal data structures.
shannon() now returns a tidy data.frame representation to simplify downstream use and improving consistency.
Cumulative frequency calculations (eq5dcf()) revised to construct a cumulative distribution based on relative frequencies. Percentage-based summaries retained for presentation.
Informational measures such as the Health State Density Index (hsdi()) now operate explicitly on proportional cumulative distributions with rounding confined to presentation contexts.
Tests updated to reflect the updated code changes.
Shiny application logic updated to align with the revised code.

DSU mapping

Updated DSU mapping lookup tables to include the UK EQ-5D value set (UK_2026). The original DSU mapping value set is now explicitly available as England_2018, with country = "UK" retained as a backwards-compatible alias. Additional DSU mappings for other countries are also available.
Utility values in DSU lookup tables are now stored rounded to 3 decimal places and copula mapping values rounded to 8 decimal places, improving consistency with standard EQ-5D reporting, reducing floating-point matching issues, and decreasing package size.

From NEWS.md in the release

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("eq5d", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("fragla/eq5d")

Development version from fragla/eq5d. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-eq5d

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled. We list this channel from recorded r2u download activity rather than from a live index of the repository, so treat it as last known rather than guaranteed.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-eq5d

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-eq5d

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed). We list this channel from recorded autoCRAN download activity rather than from a live index of the repository, so treat it as last known rather than guaranteed.

Health

CRAN checks

13OK

CRAN check page ↗

Slowest check: 2.7 min · r-oldrel-windows-x86_64

Status changes

OK13 OK2026-08-05
NOTE12 OK, 1 NOTE2026-08-01
OK14 OK2026-03-10

Advisories

none known

How this is measured·How advisories are found

Documentation

In release 0.17.0

READMEYes · 272 wordsVignettesYes · 5 · dynamicNEWSYes · 100% structured · mentions 0.17.0Citation fileNoWebsitenot declared in DESCRIPTION

Help pages: 42 (1 internal)includes a package overview page
Examples that run: 90%26 run in a plain check · 3 never run
Exported functions with examples: 73%
Documented parameters: 100%
Return-value docs: 75%
Help pages citing references: 14%

Vignettes (5)

How these are measured

Downloads

15.7K

CRAN downloads in the past year

Rank #3,464 · ~43/day · ~1.3K/mo

Releases R versions

Daily download trend is not available in this view yet.

1.3K30 days

3.1K90 days

15.7K1 year

Compare downloads with other packages →

Also on142 r2u8 autocran

How downloads are counted

Repository

fragla/eq5d ↗Account: fragla

31Stars

5Forks

1Open issues

0Open PRs

32Releases

778Commits

6Commit identities

778 commits · Last activity 2026-09-01 · +3.3% stars, 30d · Default branch at 0.17.0.9000, ahead of CRAN 0.17.0 (checked 2026-10-11)

Responsiveness

How these are sampled

PRs merged (all time): 100%
Median days to close, 50 most recently updated closed issues: 4
Median days to close, 50 most recently updated closed PRs: 0

Stars over time

2025-07-14 · 262026-09-24 · 31

How these are measured

PracticesBeta

7 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/fragla/eq5d on 2026-10-11.

Continuous integration (3)

GitHub ActionsR CMD check workflowAppVeyor

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Docs source (1)

README.Rmd

Coverage (1)

Coverage reporting (Codecov)

Reproducibility and dev environment (1)

data-raw/

Show all practicesHide 1 practice

CRAN release process (1)

cran-comments.md

How this is detected·Detection ruleset v3 (2026-09-26)

Dependencies

Declared dependencies

17 external dependencies (excludes base and recommended)

Installing eq5d adds 3 packages (2 with compiled code, 1.5 MB of source tarballs). Heaviest: rlang 766 KB, cli 629 KB, lifecycle 105 KB.

Depends (3)

R >= 3.5.0lifecycle rlang

Imports (0)

none

LinkingTo (0)

none

Suggests (15)

testthat shiny DT mime readxl ggplot2 ggiraph ggiraphExtra shinycssloaders shinyWidgets FSA PMCMRplus knitr rmarkdown covr

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

How these are counted

Code & Tests

Datasets

People & History

People (2)

Fraser Morton

Author, Maintainer since 0.1.0 (2019)

Jagtar Singh Nijjar

Author

Listed in earlier versions (1)

Jagtar Singh

no longer listed · 0.1.0 to 0.17.0

Releases (31)

Pick two releases to compare their code metrics.

0.17.0Latest
record
2026-08-28 · current release · diff ↗ ·
added 9 exports
descriptive_data, make_hsdc_by_group, make_hsdi_by_group, plot_descriptive, plot_hpg, plot_hsdc, plot_severity_summary, table_descriptive, table_ps
R
R 4.6.0 released · 2026-04-24
0.16.3
record
2026-03-30 · diff ↗
0.16.2
record
2026-02-27 · diff ↗
0.16.1
record
2025-09-10 · diff ↗
0.16.0
record
2025-06-20 · diff ↗ ·
added 1 export
RCWVH
R
R 4.5.0 released · 2025-04-11
0.15.7
record
2025-02-28 · diff ↗
0.15.6
record
2025-01-16 · diff ↗
0.15.5
record
2024-11-20 · diff ↗
0.15.4
record
2024-09-05 · diff ↗ ·
removed 1 export
Y

added 2 exports
Y3L, eq5dy3l
0.15.3
record
2024-04-29 · diff ↗
R
R 4.4.0 released · 2024-04-24
0.15.2
record
2024-01-31 · diff ↗ ·
added 3 exports
get_all_health_states, get_dimensions_from_health_states, get_health_states_from_dimensions
0.15.1
record
2023-11-20 · diff ↗
0.15.0
record
2023-07-17 · diff ↗

Show 23 earlier eventsHide 23 earlier events

R
R 4.3.0 released · 2023-04-21
0.14.0
record
2023-02-03 · diff ↗ ·
added 4 exports
hpg, hsdi, ps, shannon
0.13.0
record
2022-11-11 · diff ↗
0.12.0
record
2022-08-08 · diff ↗ ·
added 8 exports
CW, DSU3L, DSU5L, RCW, TTO, VAS, VT, Y
R
R 4.2.0 released · 2022-04-22
0.11.0
record
2022-04-05 · diff ↗ ·
added 1 export
eq5dmap
0.10.1
record
2021-11-12 · diff ↗
0.10.0
record
2021-07-27 · diff ↗ ·
added 1 export
eq5drcw
R
R 4.1.0 released · 2021-05-18
0.9.0
record
2021-04-12 · diff ↗ ·
added 1 export
eq5dy
0.8.1
record
2021-02-09 · diff ↗
0.8.0
record
2020-11-12 · diff ↗ ·
added 6 exports
eq5dcf, getDimensionsFromHealthStates, getHealthStatesFromDimensions, lfs, lss, pchc
0.7.2
record
2020-07-21 · diff ↗
0.7.1
record
2020-06-07 · diff ↗
R
R 4.0.0 released · 2020-04-24
0.7.0
record
2020-04-06 · diff ↗ ·
added 3 exports
eq5dds, getHealthStates, splitHealthStates
0.6.0
record
2020-02-04 · diff ↗
0.5.0
record
2019-12-15 · diff ↗
0.4.0
record
2019-11-12 · diff ↗
0.3.0
record
2019-09-13 · diff ↗
0.2.0
record
2019-06-27 · diff ↗
0.1.0
record
2019-05-22
R
R 3.6.0 released · 2019-04-26

Package metadata

First published: 2019-05-22
Total releases: 31 / 7 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 3.5.0
Download size: 5.6 MB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("eq5d")

Format

Morton, F., & Nijjar, J. S. (2026). eq5d: Methods for Analysing 'EQ-5D' Data and Calculating 'EQ-5D' Index Scores (Version 0.17.0) [Computer software]. https://doi.org/10.32614/CRAN.package.eq5d

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.

Format

APA

Balamuta, J. J. (2026). R Observatory: Metrics for eq5d version 0.17.0 [Data set]. HJJB, LLC. Data release v2026-10-18. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-18, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →