KHQ5D: Convert the health states of the KHQ5D to index value

In KHQ: Methods for Calculating 'KHQ' Scores and 'KHQ5D' Utility Index Scores

Description

Function used to convert the scores of the five dimensions of the KHQ5D to a single utility index using country specific value set.

Usage

KHQ5D(
  scores,
  country,
  type,
  author,
  year,
  source,
  ignore.invalid = FALSE,
  weights = NULL,
  save.xlsx = FALSE,
  filename = NULL,
  sheetName = NULL
)

Arguments

scores	data.frame with colnames RL, PL, SL, E, and S representing Role limitation, Physical limitation, Social Limitation, Emotions and Sleep. Alternatively a data.frame with the KHQ5D health profiles can be provided in a five digit format e.g., data.frame(state = c(11111, 22432, 34241, 43332)) or only the five digit e.g., 11111, c(11111), c(11111, 22432, 34241).
country	string specifying the country in which the value set scores were calculated.
type	string specifying method type used in deriving value set scores.
author	string specifying the author of the article containing the value set scores.
year	string specifying the year the article containing the value set scores was published.
source	string specifying the version of the King's Health Questionnaire used.
ignore.invalid	logical to indicate whether to ignore items data with invalid, incomplete or missing data; Default: FALSE.
weights	logical to indicate whether or not save the weights of each score of the KHQ5D. If weights = TRUE the weights will be generated and if weights and save.xlsx = TRUE an Excel file will be saved with the weights of each score plus the utility index under filename = "Res_KHQ5D_weig_uti_ind.xlsx" and sheetName = "Weights_Utility_Index". It is also possible to indicate another name, both for the file and for the sheet; Default: NULL.
save.xlsx	logical to indicate whether or not save the results; Default: FALSE.
filename	string specifying the file name if save.xlsx = TRUE; Default: "Res_KHQ5D_uti_ind.xlsx". If weights = true, default: "Res_KHQ5D_weig_uti_ind.xlsx".
sheetName	string specifying the sheet name if save.xlsx = TRUE; Default: "Utility_Index". If weights = true, default: "Weights_Utility_Index".

Details

Named vector RL, PL, SL, E and S represent Role limitation, Physical limitation, Social Limitation, Emotions and Sleep, respectfully.

Value

A data frame with utility index scores of the KHQ5D.

See Also

KHQConvKHQ5D and KHQ5DFreq

Examples

KHQ5D(scores = c(RL=1,PL=1,SL=1,E=1,S=1), country = "UK", 
  type = "SG", author = "Brazier", year = 2008, 
  source = "KHQ", ignore.invalid = TRUE, weights = NULL)

KHQ5D(scores = c(RL=1,PL=1,SL=1,E=1,S=1), country = "UK",
  type = "SG", author = "Brazier", year = 2008,
  source = "KHQ", ignore.invalid = TRUE, 
  weights = NULL, save.xlsx = FALSE, 
  filename = "Res_KHQ5D_uti_ind.xlsx",
  sheetName = "Utility_Index")

KHQ5D(scores = 11111, country = "UK", type = "SG", 
  author = "Brazier", year = 2008, source = "KHQ", 
  ignore.invalid = TRUE)

KHQ5D(scores = c(11111), country = "UK", type = "SG", 
  author = "Brazier", year = 2008, source = "KHQ", 
  ignore.invalid = TRUE)
  
KHQ5D(scores = c(11111, 22432, 34241, 43332, 22141), 
  country = "UK", type = "SG", author = "Brazier", 
  year = 2008, source = "KHQ", ignore.invalid = TRUE)

scores.df <- data.frame(
  RL = c(1,2,3,4,2), 
  PL = c(4,3,4,3,2), 
  SL = c(1,2,2,4,1), 
  E = c(1,3,4,3,4), 
  S = c(1,2,1,2,1))

KHQ5D(scores = scores.df, country = "UK", type = "SG", 
  author = "Brazier", year = 2008, source = "KHQ", 
  ignore.invalid = TRUE)

scores.df2 <- data.frame(state = c(11111, 22432, 34241, 43332, 22141))

KHQ5D(scores = scores.df2, country = "UK", type = "SG", 
  author = "Brazier", year = 2008, source = "KHQ", 
  ignore.invalid = TRUE)

KHQ5D(scores = scores.df2$state, country = "UK", type = "SG", 
  author = "Brazier", year = 2008, source = "KHQ", 
  ignore.invalid = TRUE)

KHQ5D(scores = KHQ5D_data, country = "UK", type = "SG", 
  author = "Brazier", year = 2008, source = "KHQ", 
  ignore.invalid = TRUE, weights = TRUE)

KHQ documentation built on Aug. 6, 2021, 5:07 p.m.