SATE: Survival Average Treatment Effects of a binary treatment...

In GJRM: Generalised Joint Regression Modelling

Survival Average Treatment Effects of a binary treatment variable

Description

SATE can be used to calculate the survival treatment effects of a binary treatment variable, with corresponding interval obtained using posterior simulation.

Usage

SATE(x, trt, surv.t = NULL, int.var = NULL, joint = TRUE,
     n.sim = 100, prob.lev = 0.05, ls = 10, plot.type = "survival", ...)

Arguments

x	A fitted gjrm object as produced by the respective fitting function.
trt	Name of the treatment variable.
surv.t	Numeric value for time. If not provided, the function will be calculate the SATE for each time point of a grid of lenght ls.
int.var	A vector made up of the name of the variable interacted with nm.end, and a value for it.
joint	If FALSE then the effects are obtained from the univariate model which neglects the presence of unobserved confounders. When TRUE, the effects are obtained from the simultaneous model which accounts for observed and unobserved confounders.
n.sim	Number of simulated coefficient vectors from the posterior distribution of the estimated model parameters. It may be increased if more precision is required.
prob.lev	Overall probability of the left and right tails of the SAT distribution used for interval calculations.
ls	Length of sequence to use for time variable. Only used when surv.t = NULL.
plot.type	Used when surv.t = NULL. Values allowed are: "survival" (for survival plots under treatment = 0 (grey lines) and treatment = 1 (black lines)) and "sate" (SATE evaluated at several time points).
...	Other graphics parameters to pass on to plotting commands.

Details

SATE measures the average survival difference in outcomes under treatment (the binary predictor or treatment assumes value 1) and under control (the binary treatment assumes value 0). Posterior simulation is used to obtain a confidence/credible interval.

Value

res	It returns three values: lower interval limit(s), estimated SATE(s) and upper interval limit(s).
prob.lev	Probability level used.
sim.SATE	It returns a vector containing simulated values of the survival average treatment effect for the case in which a specific time is chosen. This is used to calculate intervals.

Author(s)

Maintainer: Giampiero Marra [e-mail]

See Also

GJRM-package, gjrm

GJRM documentation built on Oct. 25, 2024, 5:07 p.m.