Parametric Survival Dialog Functions

DESCRIPTION:

These functions are used by the Parametric Survival dialog. menuSurvreg calls tabSummary.survreg if summary results are requested. The function menuSurvreg is depricated and has been replaced by menuSurvReg .

USAGE:

menuSurvreg(formula, data, subset, na.omit.p, link, dist, fixed,  
            eps, init, iter.max, print.short=F, print.long=T, save.name=NULL,  
            save.fit.p=F, save.resid.deviance.p=F, save.resid.pearson.p=F,  
            save.resid.working.p=F, save.resid.matrix.p=F) 
tabSummary.survreg(fit, print.short = F, print.long = T,  
            save.name = NULL, save.fit.p = F, save.resid.deviance.p = F,  
            save.resid.pearson.p = F, save.resid.working.p = F,  
            save.resid.matrix.p = F) 

REQUIRED ARGUMENTS:

formula
a formula object having a Surv object as the response on the left of a ~ operator, and the terms, separated by + operators, on the right.
fit
an object of class survreg.

OPTIONAL ARGUMENTS:

data
an optional data frame in which to interpret the variables occurring in the formula.
subset
an expression saying which subset of the rows of the data should be used in the fit. This can be a logical vector (which is replicated to have length equal to the number of observations), or a numeric vector indicating which observation numbers are to be included, or a character vector of the row names to be included. All observations are included by default.
na.omit.p
if TRUE, then any observation with missing values are removed from the analysis. If FALSE and there are missing values then the function will exit with a message that missing values are not allowed. If na.omit.p is TRUE then na.action is set to na.omit in the call to survreg. If na.omit.p is FALSE then na.action is set to na.fail in the call to survreg.
link
transformation to be used on the y variable.
dist
assumed distribution for the transformed y variable.
fixed
a list of fixed parameters, most often just the scale.
eps
convergence threshold. Iteration will continue until the relative change in deviance is less than eps.
init
vector of initial values of the iteration.
iter.max
maximum number of iterations to perform.
print.short
if TRUE, a short summary of the parametric survival model is printed. This output is from the function print.survreg.
print.long
if TRUE, a long summary of the parametric survival model is printed. This output is from the function summary.survreg.
save.name
a character string for the name of the data frame to save the predictions and standard errors in. If a data frame with this name already exists in database 1 and it has the appropriate number of rows then the saved values will be appended to the data frame. If the object already exist in database 1 and it is not a data frame or it does not have the appropriate number of rows then a new name is created by appending a number to save.name and the results are saved in the data frame with the new name.
save.fit.p
if TRUE, fitted values from the regression are saved in the data frame save.name.
save.resid.deviance.p
if TRUE, the deviance residuals are saved in the data frame save.name. The sum of squares of these add up to the deviance.
save.resid.pearson.p
if TRUE, the pearson residuals are saved in the data frame save.name. These are standardized residuals on the scale of the response.
save.resid.working.p
if TRUE, the working residuals from the model are saved in the data frame save.name. These are the residuals from the final IRLS fit.
save.resid.matrix.p
if TRUE, the matrix residuals from the model are saved in the data frame save.name. The maxtrix residuals are based on the derivatives of the log-likelihood function. See the residuals.survreg help file for details.

VALUE:

an object of class survreg. See the survreg.object help file for details.

SIDE EFFECTS:

The object save.name will be created or appended to if fitted values or residuals are saved.

SEE ALSO:

, ,