~ubuntu-branches/ubuntu/trusty/lme4/trusty

« back to all changes in this revision

Viewing changes to man/BIC.Rd

  • Committer: Bazaar Package Importer
  • Author(s): Dirk Eddelbuettel
  • Date: 2011-03-09 21:28:20 UTC
  • mfrom: (1.1.24 upstream) (2.2.11 sid)
  • Revision ID: james.westby@ubuntu.com-20110309212820-xgx5ui126u8ql1jp
Tags: 0.999375-39-1
* New upstream release

* debian/control: Set (Build-)Depends: to current R version

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
\name{BIC}
2
 
%\docType{genericFunction}
3
 
%\alias{BIC}
4
 
\alias{BIC,logLik-method}
5
 
\alias{BIC,ANY-method}
6
 
\title{Bayesian Information Criterion}
7
 
\description{
8
 
  The \code{\link[nlme]{BIC}} generic function calculates the Bayesian
9
 
  information criterion, also known as Schwarz's Bayesian criterion
10
 
  (SBC), for one or several fitted model objects for which a
11
 
  log-likelihood value can be obtained, according to the formula \eqn{-2
12
 
  \mbox{log-likelihood} + n_{par} \log(n_{obs})}{-2*log-likelihood +
13
 
  npar*log(nobs)}, where \eqn{n_{par}}{npar} represents the number of
14
 
  parameters and \eqn{n_{obs}}{nobs} the number of observations in the
15
 
  fitted model.
16
 
}
17
 
%\usage{
18
 
%BIC(object, \dots)
19
 
%}
20
 
% \arguments{
21
 
%   \item{object}{An object of a suitable class for the BIC to be
22
 
%     calculated - usually a \code{\link[stats]{logLik}} object
23
 
%     created by a call to the \code{\link[stats]{logLik}} generic.
24
 
%   }
25
 
%   \item{\dots}{Some methods for this generic function may take
26
 
%     additional, optional arguments.  At present none do.}
27
 
% }
28
 
\value{
29
 
  if just one object is provided, returns a numeric value with the
30
 
  corresponding BIC; if more than one object are provided, returns a
31
 
  \code{data.frame} with rows corresponding to the objects and columns
32
 
  representing the number of parameters in the model (\code{df}) and the
33
 
  BIC.
34
 
}
35
 
\references{
36
 
  Schwarz, G. (1978)
37
 
  Estimating the Dimension of a Model,
38
 
  \emph{Annals of Statistics} \bold{6}, 461--464.
39
 
}
40
 
\seealso{\code{\link[nlme]{BIC}}, \code{\link[stats]{logLik}},
41
 
  \code{\link[stats]{AIC}}}
42
 
\keyword{models}