toEQ5Dindex

Convert EQ-5D dimension scores to a five-digit profile index

The EQ-5D is a widely-used standarized instrument for measuring Health Related Quality Of Life (HRQOL),
developed by the EuroQol group <https://euroqol.org/>. It assesses five dimensions; mobility, self-care,
usual activities, pain/discomfort, and anxiety/depression, using either a three-level (EQ-5D-3L) or five-level (EQ-5D-5L) scale.
Scores from these dimensions are commonly converted into a single utility index using country-specific value sets,
which are critical in clinical and economic evaluations of healthcare and in population health surveys.
The eq5dsuite package enables users to calculate utility index values for the EQ-5D instruments,
including crosswalk utilities using the original crosswalk developed by van Hout et al. (2012) <doi:10.1016/j.jval.2012.02.008>
(mapping EQ-5D-5L responses to EQ-5D-3L index values), or the recently developed reverse crosswalk
by van Hout et al. (2021) <doi:10.1016/j.jval.2021.03.009> (mapping EQ-5D-3L responses
to EQ-5D-5L index values). Users are allowed to add and/or remove user-defined value sets.
Additionally, the package provides tools to analyze EQ-5D data according to the recommended
guidelines outlined in "Methods for Analyzing and Reporting EQ-5D data" by Devlin et al. (2020) <doi:10.1007/978-3-030-47622-9>.

Kim Rand

eq5dsuite

Handling and Analysing EQ-5d Data

Oliver Rivero-Arias

Iryna Schlackow

Anabel Estévez-Carrillo

toEQ5Dindex function

<dl><dt>x</dt>
<dd>A data.frame, matrix, or named numeric vector of EQ-5D dimension
scores. Each dimension must contain integer values (typically 1–3 or 1–5).</dd>
<dt>dim.names</dt>
<dd>Character vector of length 5 giving the dimension names, in
the conventional MO, SC, UA, PD, AD order.</dd>
<dt>na.rm</dt>
<dd>Logical. If <code>FALSE</code> (default), any <code>NA</code> in a row
produces <code>NA</code> in the output. If <code>TRUE</code>, <code>NA</code> dimensions are
treated as 0 — use with care, as this silently changes the index value.</dd>
<dt>quiet</dt>
<dd>Logical. Suppress informational messages about assumed column /
name order. Default <code>FALSE</code> so existing scripts see the same messages;
set <code>TRUE</code> inside pipelines.</dd></dl>

Arguments

Convert EQ-5D dimension scores to a five-digit profile index — toEQ5Dindex

<dl>

<dt>x</dt>
<dd>A data.frame, matrix, or named numeric vector of EQ-5D dimension
scores. Each dimension must contain integer values (typically 1–3 or 1–5).</dd>


<dt>dim.names</dt>
<dd>Character vector of length 5 giving the dimension names, in
the conventional MO, SC, UA, PD, AD order.</dd>


<dt>na.rm</dt>
<dd>Logical. If <code>FALSE</code> (default), any <code>NA</code> in a row
produces <code>NA</code> in the output. If <code>TRUE</code>, <code>NA</code> dimensions are
treated as 0 — use with care, as this silently changes the index value.</dd>


<dt>quiet</dt>
<dd>Logical. Suppress informational messages about assumed column /
name order. Default <code>FALSE</code> so existing scripts see the same messages;
set <code>TRUE</code> inside pipelines.</dd>

</dl>

toEQ5Dindex: Convert EQ-5D dimension scores to a five-digit profile index

Description

Usage

Value

Arguments

Examples