eq5dsuite-package: eq5dsuite: Standardised Tools for EQ-5D Analysis

In eq5dsuite: Handling and Analysing EQ-5d Data

eq5dsuite: Standardised Tools for EQ-5D Analysis

Description

The eq5dsuite package provides a comprehensive set of functions for calculating EQ-5D preference-based values and analysing EQ-5D data following the recommendations of Devlin et al. (2020).

The package supports three EQ-5D instruments:

• EQ-5D-3L

• EQ-5D-5L

• EQ-5D-Y-3L

Value calculation

Functions for calculating EQ-5D preference-based values:

• eq5d — Generic calculator for all instruments

• eq5d3l — EQ-5D-3L value calculation

• eq5d5l — EQ-5D-5L value calculation

• eq5dy3l — EQ-5D-Y-3L value calculation

• eqxw — Original crosswalk method (van Hout et al., 2012)

• eqxwr — Reverse crosswalk method (van Hout and Shaw, 2021)

• eqxw_UK — UK-specific NICE-recommended mapping (Hernandez Alava et al., 2023)

Value set management

Functions for managing country-specific value sets:

• eqvs_display — List all available value sets

• eqvs_add — Add a custom value set

• eqvs_drop — Remove a custom value set

• eqvs_load — Load a saved custom value set into the current session

• update_value_sets — Check for and install new value sets from the online repository

Profile analysis

Functions for analysing EQ-5D health state profiles, including cross-sectional summaries, longitudinal change analyses, and severity metrics:

• eq5d_profile_level_summary — Cross-sectional frequency summary by dimension

• eq5d_profile_level_summary_by_group — Stratified frequency summary by subgroup

• eq5d_profile_top_states — Most frequently observed health state profiles

• eq5d_profile_change_summary — Dimension-level frequencies at two time points

• eq5d_profile_dimension_change_table — Changes in levels per dimension as percentages of total and of type of change

• eq5d_profile_pchc_table — Paretian Classification of Health Change table

• eq5d_profile_pchc_with_no_problems_table — PCHC table with no-problems category

• eq5d_profile_pchc_by_group_plot — PCHC bar chart by subgroup

• eq5d_profile_better_dimensions_by_group_plot — Dimensions improved among Better patients

• eq5d_profile_worse_dimensions_by_group_plot — Dimensions worsened among Worse patients

• eq5d_profile_mixed_dimensions_by_group_plot — Dimensions changed among Mixed patients

• eq5d_profile_health_profile_grid — Health Profile Grid of individual transitions

• eq5d_profile_lss_utility_summary — Descriptive statistics by Level Sum Score

• eq5d_profile_lss_utility_plot — EQ-5D values plotted against LSS

• eq5d_profile_lfs_distribution — Level Frequency Score distribution table

• eq5d_profile_lfs_mean_utility — Mean EQ-5D values by LFS category

• eq5d_profile_lfs_utility_summary — Descriptive statistics by Level Frequency Score

• eq5d_profile_lfs_utility_plot — EQ-5D values plotted against LFS

• eq5d_profile_density_curve — Health State Density Curve

EQ-5D value analysis

Functions for analysing EQ-5D preference-based values across time points, subgroups, and population norms:

• eq5d_utility_summary — Descriptive statistics at each time point

• eq5d_utility_summary_by_group — Descriptive statistics stratified by subgroup

• eq5d_utility_norms_comparison — Comparison with population norms by age and sex

• eq5d_utility_over_time_plot — Mean values with confidence intervals over time

• eq5d_utility_by_group_plot — Mean values with confidence intervals by subgroup

• eq5d_utility_change_by_group_plot — Longitudinal change by subgroup

• eq5d_utility_distribution_plot — Histogram of EQ-5D value distribution

• eq5d_utility_vas_scatter_plot — Scatter plot of EQ-5D values against EQ-VAS

EQ-VAS analysis

Functions for analysing EQ-VAS self-rated health scores:

• eq5d_vas_summary — Descriptive statistics at each time point

• eq5d_vas_distribution_table — Frequency distribution in pre-defined ranges

• eq5d_vas_histogram — Histogram of EQ-VAS scores

• eq5d_vas_grouped_distribution_plot — Bar chart of grouped EQ-VAS frequencies

Helper functions

Utility functions for preparing EQ-5D data:

• toEQ5Dindex — Combine dimension columns into a 5-digit profile code

• toEQ5Ddims — Split a 5-digit profile code into separate dimension columns

• make_all_EQ_indexes — Generate all valid EQ-5D state codes as a vector

• make_all_EQ_states — Generate all valid EQ-5D states as a data frame

• make_dummies — Create dummy variables from EQ-5D dimension columns

Interactive application

A Shiny application providing point-and-click access to the same analytical workflow without requiring R coding:

• run_app — Launch the Shiny application

Cross-platform suite

eq5dsuite is part of a cross-platform suite also available in Stata and Excel:

• Full suite: https://github.com/MathsInHealth/eq5dsuite

• R package: https://github.com/MathsInHealth/eq5dsuite-r

• Value sets repository: https://github.com/MathsInHealth/eq5dsuite-value-sets

Author(s)

Anabel Estévez-Carrillo, Oliver Rivero-Arias, Iryna Schlackow, Kim Rand

Maintainer: Anabel Estévez-Carrillo [e-mail]

References

Devlin N, Parkin D, Janssen B (2020). Methods for Analysing and Reporting EQ-5D Data. Springer, Cham. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1007/978-3-030-47622-9")}

van Hout B, Janssen MF, Feng YS, et al. (2012). Interim scoring for the EQ-5D-5L: mapping the EQ-5D-5L to EQ-5D-3L value sets. Value in Health, 15(5), 708–715. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1016/j.jval.2012.02.008")}

eq5dsuite documentation built on May 14, 2026, 5:07 p.m.