logLik.lme               package:nlme               R Documentation

_L_o_g-_L_i_k_e_l_i_h_o_o_d _o_f _a_n _l_m_e _O_b_j_e_c_t

_D_e_s_c_r_i_p_t_i_o_n:

     If 'REML=FALSE', returns the log-likelihood value of the linear
     mixed-effects model represented by 'object' evaluated at the
     estimated  coefficients; else, the restricted log-likelihood
     evaluated at the estimated coefficients is returned.

_U_s_a_g_e:

     ## S3 method for class 'lme':
     logLik(object, REML, ...)

_A_r_g_u_m_e_n_t_s:

  object: an object inheriting from class 'lme', representing a fitted
          linear mixed-effects model.

    REML: an optional logical value.  If 'TRUE' the restricted
          log-likelihood is returned, else, if 'FALSE', the
          log-likelihood is returned. Defaults to the method of
          estimation used, that is 'TRUE' if and only 'object' was
          fitted with 'method = "REML"' (the default for these fitting
          functions) . 

     ...: some methods for this generic require additional arguments. 
          None are used in this method.

_V_a_l_u_e:

     the (restricted) log-likelihood of the model represented by
     'object' evaluated at the estimated coefficients.

_A_u_t_h_o_r(_s):

     Jose Pinheiro and Douglas Bates

_R_e_f_e_r_e_n_c_e_s:

     Harville, D.A. (1974) ``Bayesian Inference for Variance Components
     Using Only Error Contrasts'', _Biometrika_, *61*, 383-385.

     Pinheiro, J.C., and Bates, D.M. (2000) "Mixed-Effects Models in S
     and S-PLUS", Springer.

_S_e_e _A_l_s_o:

     'lme','gls', 'logLik.corStruct', 'logLik.glsStruct',
     'logLik.lmeStruct', 'logLik.lmList', 'logLik.reStruct',
     'logLik.varFunc',

_E_x_a_m_p_l_e_s:

     fm1 <- lme(distance ~ Sex * age, Orthodont, random = ~ age, method = "ML")
     logLik(fm1)
     logLik(fm1, REML = TRUE)