R/data-xc1.R

In R2MLwiN: Running 'MLwiN' from Within R

#' Examination scores of 16-year olds in Fife, Scotland.
#' 
#' A dataset of examination scores of 16-year olds in Fife, Scotland, in which
#' the secondary school the pupil attended is cross-classified by the primary
#' school the pupil attended.
#' 
#' The \code{xc1} dataset is one of the sample datasets provided with the
#' multilevel-modelling software package MLwiN (Rasbash et al., 2009), analysed
#' by Paterson (1991). The data are cross-classified in that not all children
#' who attended the same primary school subsequently entered the same secondary
#' school. See also Browne (2012).
#' 
#' @docType data
#' @format A data frame with 3435 observations on the following 11 variables:
#' \describe{ \item{list("vrq")}{A verbal reasoning score resulting from tests
#' pupils took when they entered secondary school.}
#' \item{list("attain")}{Attainment score of pupils at age sixteen.}
#' \item{list("pid")}{Primary school identifying code.}
#' \item{list("sex")}{Pupils' gender: a factor with levels \code{Male} and
#' \code{Female}.} \item{list("sc")}{Pupils' social class (scaled from low to
#' high).} \item{list("sid")}{Secondary school identifying code.}
#' \item{list("fed")}{Fathers' education.} \item{list("choice")}{Choice number
#' of secondary school attended (where 1 is first choice, etc.)}
#' \item{list("med")}{Mothers' education.} \item{list("cons")}{A column of
#' ones. If included as an explanatory variable in a regression model (e.g. in
#' MLwiN), its coefficient is the intercept.} \item{list("pupil")}{Pupil
#' identifying code.} }
#' @seealso See \code{mlmRev} package for an alternative format of the same
#' dataset.
#' @source Browne, W. J. (2012) \emph{MCMC Estimation in MLwiN Version 2.26.}
#' University of Bristol: Centre for Multilevel Modelling.
#' 
#' Paterson, L. (1991) Socio economic status and educational attainment: a
#' multidimensional and multilevel study. \emph{Evaluation and Research in
#' Education}, 5, 97-121.
#' 
#' Rasbash, J., Charlton, C., Browne, W.J., Healy, M. and Cameron, B. (2009)
#' \emph{MLwiN Version 2.1.} Centre for Multilevel Modelling, University of
#' Bristol.
#' @keywords datasets
#' @examples
#' 
#' \dontrun{
#' 
#' data(xc1, package = "R2MLwiN")
#' 
#' (mymodel <- runMLwiN(attain ~ 1 + (1 | sid) + (1 | pid) + (1 | pupil),
#'  estoptions = list(xc = TRUE, EstM = 1), data = xc1))
#' 
#' }
#' 
"xc1"