QoLR (version 1.0.1)

write.TTD: Write in a csv file the results of the time to deterioration analysis

Description

A program that computes the time to deterioration in a quality of life score and print the results in a csv file according to treatment arm

Usage

write.TTD(X, score = "", order = 1, ref.init = "baseline", MCID, death = NA, 
group = NULL, names.group, sensitivity = TRUE, file = "")

Arguments

X

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

score

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

order

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

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

MCID

vector equals to the minimal clinically important difference (MCID). Several MCID can be specified

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

group

the name of the variable in X corresponding to the treatment arm. Only two groups are allowed

names.group

the name of each treatment group to print

sensitivity

Boolean equals to TRUE by default. If sensitivity is TRUE, then all sensitivity analyses are performed, integrating patients with no baseline or with no follow up as event, death as event and simultaneously no baseli

file

the name of the csv file to create with the results of the time to deterioration analysis

Value

• this function does not return value in R console but creates a csv file with the results of the time to deterioration analysis

See Also

TTD

Examples

### The time to deterioration of scores "QoL" and "pain" of the dataqol2 data
### set as compared to the baseline score
### with two MCID (5 points and 10 points)
### and according to the treatment arm called "arm"
### all sensitivity analyses are performed simultaneously to the main definition
### the created file is named "file_TTD_baseline.csv" and is located 
### in the current directory                             
            
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 \code{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),]
                     
###write.TTD(dataqol_final,score=c("QL","PA"),order=c(1,2),MCID=c(5,10),
###group="Arm",names.group=c("Arm 1","Arm 2"),sensitivity=FALSE,
###file="file_TTD_baseline")