rstrans               package:relsurv               R Documentation

_F_i_t _C_o_x _P_r_o_p_o_r_t_i_o_n_a_l _H_a_z_a_r_d_s _M_o_d_e_l _i_n _T_r_a_n_s_f_o_r_m_e_d _T_i_m_e

_D_e_s_c_r_i_p_t_i_o_n:

     The function transforms each person's time to his/her probability
     of dying at that time according to the ratetable. It then fits the
     Cox proportional hazards model with the transformed times as a 
     response. A possible side effect are the transformed times.

_U_s_a_g_e:

     rstrans(formula, data, ratetable, int,na.action,init,control,...)

_A_r_g_u_m_e_n_t_s:

 formula: a formula object, with the response on the left of a '~'
          operator, and the terms on the right. The terms consist of
          predictor variables separated by the '+' operator, along with
          a 'ratetable' term. The 'ratetable' term matches each subject
          to his/her expected cohort.If the variables are organized and
          named in the same way as in the population tables, the
          'ratetable' term can be omitted. The response must be a
          survival object as returned by the 'Surv' function. The time
          must be in days.   

    data: a data.frame in which to interpret the variables named in the
          'formula'.   

ratetable: a table of event rates, such as 'survexp.us'.  

     int: the number of follow-up years used for calculating
          survival(the rest is censored). If missing, it is set the 
          the maximum observed follow-up time. 

na.action: a missing-data filter function, applied to the model.frame,
          after any subset argument has been used.  Default is
          'options()$na.action'. 

    init: vector of initial values of the iteration.  Default initial
          value is zero for all variables. 

 control: a list of parameters for controlling the fitting process. 
          See the documentation for 'coxph.control' for details. 

     ...: other arguments will be passed to 'coxph.control'.

_V_a_l_u_e:

     an object of class 'coxph'. See 'coxph.object' and 'coxph.detail'
     for details.   

       y: an object of class 'Surv' containing the transformed times. 

_R_e_f_e_r_e_n_c_e_s:

     Stare J., Henderson R., Pohar M. "An individual measure for
     Relative Survival." _Journal of the Royal Statistical Society:
     Series C_ , 54 115-126, 2005.

_S_e_e _A_l_s_o:

     'rsmul', 'invtime', 'rsadd', 'survexp'.

_E_x_a_m_p_l_e_s:

     data(slopop)
     data(rdata)
     rstrans(Surv(time,cens)~sex+as.factor(agegr)+ratetable(age=age*365,
             sex=sex,year=year),ratetable=slopop,data=rdata)

