getVarCov                package:nlme                R Documentation

_E_x_t_r_a_c_t _v_a_r_i_a_n_c_e-_c_o_v_a_r_i_a_n_c_e _m_a_t_r_i_x

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

     Extract the variance-covariance matrix from a fitted model, such
     as a mixed-effects model.

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

     getVarCov(obj, ...)
     ## S3 method for class 'lme':
     getVarCov(obj, individuals,
         type = c("random.effects", "conditional", "marginal"), ...)
     ## S3 method for class 'gls':
     getVarCov(obj, individual = 1, ...)

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

     obj: A fitted model.  Methods are available for models fit by
          'lme' and by 'gls'

individuals: For models fit by 'lme' a vector of levels of the grouping
          factor can be specified for the conditional or marginal
          variance-covariance matrices.

individual: For models fit by 'gls' the only type of
          variance-covariance matrix provided is the marginal
          variance-covariance of the responses by group.  The optional
          argument 'individual' specifies the group of responses.

    type: For models fit by 'lme' the 'type' argument specifies the
          type of variance-covariance matrix, either '"random.effects"'
          for the random-effects variance-covariance (the default), or
          '"conditional"' for the conditional. variance-covariance of
          the responses or '"marginal"' for the the marginal
          variance-covariance of the responses.

     ...: Optional arguments for some methods, as described above

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

     A variance-covariance matrix or a list of variance-covariance
     matrices.

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

     Mary Lindstrom lindstro@biostat.wisc.edu

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

     'lme', 'gls'

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

     fm1 <- lme(distance ~ age, data = Orthodont, subset = Sex == "Female")
     getVarCov(fm1)
     getVarCov(fm1, individual = "F01", type = "marginal")
     getVarCov(fm1, type = "conditional")
     fm2 <- gls(follicles ~ sin(2*pi*Time) + cos(2*pi*Time), Ovary,
                correlation = corAR1(form = ~ 1 | Mare))
     getVarCov(fm2)

