Title: Empirical Likelihood (EL) for Comparing Two Survival Functions
Version: 1.1
Description: Functions for computing critical values and implementing the one-sided/two-sided EL tests.
Depends: R (≥ 2.13.0)
Imports: survival, stats
License: GPL-2 | GPL-3 [expanded from: GPL (≥ 2)]
LazyData: true
Author: Hsin-wen Chang [aut, cre] <hwchang@stat.sinica.edu.tw>
Maintainer: Guo-You Lan <jj6020770416jj@gmail.com>
Archs: i386, x64
RoxygenNote: 6.1.0
NeedsCompilation: no
Packaged: 2018-08-13 08:23:50 UTC; Wally
Repository: CRAN
Date/Publication: 2018-08-13 09:00:13 UTC

Simulated Survival with Crossing Hazard Functions

Description

The data frame hazardcross is simulated from two groups of piecewise exponential lifetime distributions with crossing hazard functions. The estimated survival functions remain ordered even when the estimated hazard functions are crossed. See supELtest for the application.

Usage

hazardcross

Format

The hazardcross is a data frame with 100 simulated observations of 3 variables, and has the following columns:

See Also

supELtest


Survival from Severe Alcoholic Hepatitis

Description

The data frame hepatitis is obtained by digitizing the published Kaplan-Meier curves in Nguyen-Khac et al (2011). The method of digitizing is described in Guyot et al. (2012). See intELtest and ptwiseELtest for the application.

Usage

hepatitis

Format

The hepatitis is a data frame with 174 observations of 3 variables, and has the following columns:

Source

Nguyen-Khac et al., "Glucocorticoids plus N-Acetylcysteine in Severe Alcoholic Hepatitis," The New England Journal of Medicine, Vol. 365, No. 19, pp. 1781-1789 (2011). http://www.nejm.org/doi/full/10.1056/NEJMoa1101214#t=article

References

P. Guyot, A. E. Ades, M. J. N. M. Ouwens, and N. J. Welton, "Enhanced secondary analysis of survival data: reconstructing the data from published Kaplan-Meier survival curves," BMC Medical Research Methodology, 12(1):9. http://bmcmedresmethodol.biomedcentral.com/articles/10.1186/1471-2288-12-9

See Also

intELtest, ptwiseELtest


The integrated likelihood ratio test

Description

intELtest gives a class of the weighted likelihood ratio statistics:

\sum_{t\in U}w(t)\{-2\log R(t)\},

where w(t) is an objective weight function, and R(t) is an empirical likelihood (EL) ratio that compares two survival functions at each time point t in the set of observed uncensored lifetimes, U.

Usage

intELtest(data, g1 = 1, t1 = 0, t2 = Inf, sided = 2,
  nboot = 1000, wt = "p.event", alpha = 0.05, compo = FALSE,
  seed = 1011, nlimit = 200)

Arguments

data

a data frame/matrix with 3 columns. The first column is the survival time. The second is the censoring indicator. The last is the grouping variable. An example as the input to data provided is hepatitis.

g1

the group with longer survival in one-sided testing with the default value of 1.

t1

pre-specified t_1 based on domain knowledge with the default value of 0

t2

pre-specified t_2 based on domain knowledge with the default value of \infty

sided

2 if two-sided test, and 1 if one-sided test. It assumes the default value of 2.

nboot

number of bootstrap replications in calculating critical values with the defualt value of 1000.

wt

a string for the integral statistic with a specific weight function. There are four types of integral statistics provided: "p.event", "dF", "dt", and "db". It assumes the default value of "p.event". See 'Details' for more about the integral statistics.

alpha

pre-specified significance level of the test with the default value of 0.05

compo

FALSE if taking the standardized square of the difference as the local statisic for two-sided testing, and TRUE if constructing for one-sided testing, but only the positive part of the difference included. It assumes the default value of FALSE.

seed

the parameter with the default value of 1011 to set.seed for generating bootstrap-based critical values in R. The set.seed is used implicitly in intELtest.

nlimit

the splitting unit with the default value of 200. To deal with large data problems, the bootstrap algorithm is to split the number of bootstrap replicates into nsplit parts. The number nsplit is the smallest integer not less than \left\| U\right\|/nlimit.

Details

intELtest calculates the weighted likelihood ratio statistics:

\sum_{i=1}^{h}w_i\cdot \{-2\log R(t_i)\},

where w_1,...,w_h are the values of the weight function evaluated at the distinct ordered uncensored times t_1,...,t_h in U. There are four types of weight functions considered.

Value

intELtest returns a list with three elements:

References

See Also

hepatitis, supELtest, ptwiseELtest

Examples

library(EL2Surv)
intELtest(hepatitis)

## OUTPUT:
## $teststat
## [1] 1.406016
## 
## $critval
## [1] 0.8993514
## 
## $pvalue
## [1] 0.012


The pointwise likelihood ratio test

Description

ptwiseELtest gives pointwise EL statistic values at uncensored time span. The pointwise statistic considers only the decision on each single time point; thus, it is different from the integral type and sup type statistics.

Usage

ptwiseELtest(data, g1 = 1, t1 = 0, t2 = Inf, sided = 2,
  nboot = 1000, alpha = 0.05, compo = FALSE, seed = 1011,
  nlimit = 200)

Arguments

data

a data frame/matrix with 3 columns. The first column is the survival time. The second is the censoring indicator. The last is the grouping variable. An example as the input to data provided is hepatitis.

g1

the group with longer survival in one-sided testing with the default value of 1.

t1

pre-specified t_1 based on domain knowledge with the default value of 0

t2

pre-specified t_2 based on domain knowledge with the default value of \infty

sided

2 if two-sided test, and 1 if one-sided test. It assumes the default value of 2.

nboot

number of bootstrap replications in calculating critical values with the defualt value of 1000.

alpha

pre-specified significance level of the test with the default value of 0.05

compo

FALSE if taking the standardized square of the difference as the local statisic for two-sided testing, and TRUE if constructing for one-sided testing, but only the positive part of the difference included. It assumes the default value of FALSE.

seed

the parameter with the default value of 1011 to set.seed for generating bootstrap-based critical values in R. The set.seed is used implicitly in intELtest.

nlimit

the splitting unit with the default value of 200. To deal with large data problems, the bootstrap algorithm is to split the number of bootstrap replicates into nsplit parts. The number nsplit is the smallest integer not less than \left\| U\right\|/nlimit.

Value

ptwiseELtest returns a list with four elements:

References

H.-w. Chang and I. W. McKeague, "Empirical likelihood based tests for stochastic ordering under right censorship," Electronic Journal of Statistics, Vol. 10, No. 2, pp. 2511-2536 (2016).

See Also

hepatitis, intELtest, supELtest

Examples

library(EL2Surv)
ptwiseELtest(hepatitis)
## It produces the estimates on 44 distinct uncensored days
## out of 57 possibly repeated uncensored days.

ptwiseELtest(hepatitis, t1 = 30, t2 = 60)
## It produces the estimates on 12 distinct uncensored days
## on the restricted time interval [30, 60].


The maximally selected likelihood ratio test

Description

supELtest provides a maximal deviation type statistics that is better adapted at detecting local differences:

\sup_{t\in U}\{-2\log R(t)\},

where R(t) is an empirical likelihood (EL) ratio that compares two survival functions at each time point t in the set of observed uncensored lifetimes, U.

Usage

supELtest(data, g1 = 1, t1 = 0, t2 = Inf, sided = 2,
  nboot = 1000, alpha = 0.05, compo = FALSE, seed = 1011,
  nlimit = 200)

Arguments

data

a data frame/matrix with 3 columns. The first column is the survival time. The second is the censoring indicator. The last is the grouping variable. An example as the input to data provided is hepatitis.

g1

the group with longer survival in one-sided testing with the default value of 1.

t1

pre-specified t_1 based on domain knowledge with the default value of 0

t2

pre-specified t_2 based on domain knowledge with the default value of \infty

sided

2 if two-sided test, and 1 if one-sided test. It assumes the default value of 2.

nboot

number of bootstrap replications in calculating critical values with the defualt value of 1000.

alpha

pre-specified significance level of the test with the default value of 0.05

compo

FALSE if taking the standardized square of the difference as the local statisic for two-sided testing, and TRUE if constructing for one-sided testing, but only the positive part of the difference included. It assumes the default value of FALSE.

seed

the parameter with the default value of 1011 to set.seed for generating bootstrap-based critical values in R. The set.seed is used implicitly in intELtest.

nlimit

the splitting unit with the default value of 200. To deal with large data problems, the bootstrap algorithm is to split the number of bootstrap replicates into nsplit parts. The number nsplit is the smallest integer not less than \left\| U\right\|/nlimit.

Value

supELtest returns a list with three elements:

References

H.-w. Chang and I. W. McKeague, "Empirical likelihood based tests for stochastic ordering under right censorship," Electronic Journal of Statistics, Vol. 10, No. 2, pp. 2511-2536 (2016).

See Also

hazardcross, intELtest, ptwiseELtest

Examples

library(EL2Surv)
supELtest(hazardcross)

## OUTPUT:
## $teststat
## [1] 8.945539
## 
## $critval
## [1] 8.738189
## 
## $pvalue
## [1] 0.045

mirror server hosted at Truenetwork, Russian Federation.