# logLik.lme

##### Log-Likelihood of an lme Object

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.

- Keywords
- models

##### Usage

```
# S3 method for lme
logLik(object, REML, …)
```

##### Arguments

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

##### Value

the (restricted) log-likelihood of the model represented by
`object`

evaluated at the estimated coefficients.

##### References

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.

##### See Also

`lme`

,`gls`

,
`logLik.corStruct`

,
`logLik.glsStruct`

,
`logLik.lmeStruct`

,
`logLik.lmList`

,
`logLik.reStruct`

,
`logLik.varFunc`

,

##### Examples

```
# NOT RUN {
fm1 <- lme(distance ~ Sex * age, Orthodont, random = ~ age, method = "ML")
logLik(fm1)
logLik(fm1, REML = TRUE)
# }
```

*Documentation reproduced from package nlme, version 3.1-148, License: GPL (>= 2) | file LICENCE*