update                 package:base                 R Documentation

_U_p_d_a_t_e _a_n_d _R_e-_f_i_t _a _M_o_d_e_l _C_a_l_l

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

     `update' will update and (by default) re-fit a model. It does this
     by extracting the call stored in the object, updating the call and
     (by default) evaluating that call. Sometimes it is useful to call
     `update' with only one argument, for example if the data frame has
     been corrected.

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

     update(object, ...)
     update.default(object, formula, ..., evaluate = TRUE)

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

  object: An existing fit from a model function such as `lm', `glm' and
          many others.

 formula: Changes to the formula - see `update.formula' for details.

     ...: Additional arguments to the call, or arguments with changed
          values. Use `name=NULL' to remove the argument `name'.

evaluate: If true evaluate the new call else return the call.

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

     If `evaluate = TRUE' the fitted object, otherwise the updated
     call.

_A_u_t_h_o_r(_s):

     B.D. Ripley

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

     `update.formula'

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

     oldcon <- options(contrasts = c("contr.treatment", "contr.poly"))
     ## Annette Dobson (1990) "An Introduction to Generalized Linear Models".
     ## Page 9: Plant Weight Data.
     ctl <- c(4.17,5.58,5.18,6.11,4.50,4.61,5.17,4.53,5.33,5.14)
     trt <- c(4.81,4.17,4.41,3.59,5.87,3.83,6.03,4.89,4.32,4.69)
     group <- gl(2, 10, 20, labels = c("Ctl", "Trt"))
     weight <- c(ctl, trt)
     lm.D9 <- lm(weight ~ group)
     lm.D9
     summary(lm.D90 <- update(lm.D9, . ~ . - 1))
     options(contrasts = c("contr.helmert", "contr.poly"))
     update(lm.D9)
     options(oldcon)

