\name{getEMParametersForAMD}
\alias{getEMParametersForAMD}
\alias{getLMParametersForAMD}
\title{
 This gets all of the parameters for an Assessment Model Description
File and puts them into one big group.
}
\usage{
 getEMParametersForAMD(filename, chatty=FALSE)
 getLMParametersForAMD(filename, chatty=FALSE)
}

\arguments{
  \item{filename}{Name of the Assessment Model Description File.}
  \item{chatty}{A logical value, if true, then progress messages about
    files read will printed.}
}
\value{
  A list of lists of \code{parameterVector} objects.  There is one list for
  each Evidence or Link model in the Assessment Model Description, and
  one \code{parameterVector} object for each DiBello--Samejima type
  distribution in that model. 

  Names of the objects given names of the models and the variables.
}
\description{
  This reads and parses the XML associated with an Assessment Model
  Description files and all of the assocated GM files.  This is usually
  the first step in building a Q-Matrix, using \code{buildQMatrix}.
  The function \code{getEMParametersForAMD} is suitable for Assessment
  Model Descriptions (with Evidence Models) coming out of Portal.
  The function \code{getLMParametersForAMD} is suitable for Assessment
  Descriptions (with Link Models) coming out of the StatShop calibrator
  of AMDF2ADF converter.

}
\references{
  http://research.ets.org/~ralmond/StatShop/dataFormats.html
}
\author{Russell Almond}
\seealso{
  \code{\link{parameterVector}},\code{\link{buildQMatrix}}
}
\examples{
# Assumes that StatShop is installed on the test machine
StatShop <- Sys.getenv("STATSHOP")
if (StatShop == "") {
  warn("StatShop not installed, skipping test.")
} else {
fc <- paste(StatShop,"TestScripts","ICT","Version0","Hybrid","FixedContext",
      sep=.Platform$file.sep)

## This command finds the name of the AMD files in the current
## directory.  Rest of the script assumes that the first one is the
## one you want to use.
amds <- list.files(fc,".amd.xml$")
amdfile <- paste(fc,amds[1],sep=.Platform$file.sep)

## This version of the command for Assessment Description files, it
## looks at link models.
alllmp <- getLMParametersForAMD(amdfile)

## This version of the command works with Assessment Model Description 
## files (from Portal), it looks at evidence models.
allemp <- getEMParametersForAMD(amdfile)

### This command builds the Q-Matrix
QM <- buildQMatrix(allemp)
}
}
\keyword{interface}