QoLR (version 1.0.1)

TTD: Time to Quality of Life score deterioration

Description

A program that computes the time to deterioration in a quality of life score.

Usage

TTD(X, score = "", MCID, ref.init = "baseline", order = 1, 
no_baseline = "censure", no_follow = "censure", death = NA, sensitivity = FALSE)

Arguments

X

input data matrix or data frame with at least one quality of life score. Missing values are inserted as NA.

score

vector with the name of the quality of life scores of interest

MCID

the minimal clinically important difference

ref.init

the reference score to qualify the deterioration. By default, ref.init is "baseline", i.e. the reference score is the baseline score. If ref.init is "best", the best previous quality of life scor

order

a vector equals to 1 if the deterioration corresponds to a decrease of the score, 2 otherwise

no_baseline

By default, no_baseline equals to "censure" to indicate that patients with no baseline score are censured at baseline (Day 0). If no_baseline equals "event", these patients are deteriorated since baselin

no_follow

By default, no_follow equals to "censure" to indicate that patients with no follow-up score are censured just after baseline (Day 1). If no_follow equals to "event", these patients are deteriorated just

death

missing if patients who died without experienced a deterioration are censored at the time of the last quality of life assessment, equals to the name of the death date in the dataframe X otherwise

sensitivity

Boolean equals to FALSE by default. If sensitivity is TRUE, then all sensitivity analyses are performed, integrating patients with no baseline or with no follow up as event (SA1), death as event (SA2) and simultaneou

Value

• The result is a dataframe with the id variable of the dataframe X and the results of the time to deterioration analyses performed. For each score and each time to deterioration analysis, two variables are created called event and time with the name of the corresponding score as a suffix. Moreover, if sensitivity is TRUE, a suffix is added to each result of this function reflecting the sensitivity analysis corresponding (SA1, SA2 or SA3). The first variable event is a dummy vector equals to 1 if the patient is deteriorated and 0 if not. The second variable time equals to the time in months to deterioration since baseline if the patient is deteriorated or the time to censure. As example, for a given score "qol" and one analyse performed (i.e. sensitivity is FALSE), then two variables are created called event.qol and time.qol.

Details

To apply this function, the dataset must respect a general structure. The dataset X must be in long format with the following variables in this order:

1. Patient's identification number

Variable identify the number of the quality of life assessment, i.e. the visit number Date of quality of life measures quality of life scores Other variables as the date of death or the treatment arm.

References

Anota A., et al. Time to Health-related Quality of Life score deterioration as a modality of longitudinal analysis for health-related quality of life studies in oncology: do we need RECIST for quality of life to achieve standardization? Qual Life Res. 2013 Nov 26. Hamidou Z., et al. Time to deterioration in quality of life score as a modality of longitudinal analysis in patients with breast cancer. The Oncologist 2011, 16(10):1458-1468.

See Also

TUDD

Examples

data(dataqol)
# Estimation of the scores using the 'scoring.QLQC30' function:
score_dataqol=scoring.QLQC30(dataqol,id="Id",time="time")
# Merge of "score_dataqol" dataframe with the important 
# variables of the dataqol dataframe as follows:
info=dataqol[,c("Id","time","date","death","Arm")]
dataqol_final=merge(score_dataqol,info,by=c("Id","time"))

# Then we reorganized the obtained "dataqol_final" dataset in order that
# the "date" variable appeared in the third position:
dataqol_final=dataqol_final[,c(1:2,18,3:17,19:20)]

# Finally, in order to apply the "TTD" function, the dataset has to be sorted by
# patient's identification number "Id" and HRQoL measures ("time"):
dataqol_final=dataqol_final[order(dataqol_final$time),]
dataqol_final=dataqol_final[order(dataqol_final$Id),]

# Time to "QL" score deterioration with a minimal clinically important difference
# of 5 points at least as compared to the baseline score:
ttd1=TTD(dataqol_final, score="QL", MCID=5)