rsmul                package:relsurv                R Documentation

_F_i_t _A_n_d_e_r_s_e_n _e_t _a_l _M_u_l_t_i_p_l_i_c_a_t_i_v_e _R_e_g_r_e_s_s_i_o_n _M_o_d_e_l _f_o_r _R_e_l_a_t_i_v_e _S_u_r_v_i_v_a_l

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

     Fits the Andersen et al multiplicative regression model in
     relative survival. An extension of the  coxph function using
     relative survival.

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

     rsmul(formula, data, ratetable = survexp.us, int,na.action,init,method,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. 

  method: the default method 'mul' assumes hazard to be constant on
          yearly intervals. Method 'mul1' uses the ratetable to
          determine the time points when hazard changes. The 'mul1'
          method is therefore more accurate, but at the same time can
          be more computationally intensive.

 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'.

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

     Andersen, P.K., Borch-Johnsen, K., Deckert, T., Green, A.,
     Hougaard, P., Keiding, N. and Kreiner, S. "A Cox regression model
     for relative mortality and its application to diabetes mellitus
     survival data.", _Biometrics,_ 921-932, 1985.

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

     'rsadd', 'rstrans'.

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

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

