% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/simulate.R
\name{sim_recovery}
\alias{sim_recovery}
\title{Parameter recovery of a fit against the simulation truth}
\usage{
sim_recovery(fit, sim)
}
\arguments{
\item{fit}{A fit of the simulated data (\code{\link{rasch}},
\code{\link{btl}}, \code{\link{rasch_mfrm}}, or \code{\link{rasch_efrm}}).}

\item{sim}{The simulated data (from a \code{simulate_*} function).}
}
\value{
A list of class \code{"rasch_recovery"}: \code{summary} (per
  parameter type: n, correlation, RMSE, bias) and \code{pieces} (the true
  and estimated values behind each).
}
\description{
Compares the parameters recovered by a fit with the ones a
\code{simulate_*} function planted (carried on the data as
\code{attr(sim, "truth")}): item difficulties and person abilities for a
Rasch fit, object locations for a paired-comparison fit, rater severities
(with item and person measures) for a many-facet fit, and the set units for
a frames fit. Locations are mean-centred before comparison, since the model
identifies them only up to an origin.
}
\examples{
d <- simulate_rasch(500, 12, seed = 1)
sim_recovery(rasch(d, id = "id"), d)$summary
}
