% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/priors.R
\name{prior_species}
\alias{prior_species}
\title{Species-Specific Priors from the AmP Collection}
\usage{
prior_species(
  species,
  type = c("individual", "growth_repro", "hierarchical", "debtox")
)
}
\arguments{
\item{species}{Character string: species name with underscore
separator (e.g., \code{"Eisenia_fetida"}).  Case-insensitive.}

\item{type}{Model type for filling model-specific defaults.}
}
\value{
Named list of \code{bdeb_prior} objects, suitable for the
\code{priors} argument of \code{\link[=bdeb_model]{bdeb_model()}} or \code{\link[=bdeb_tox]{bdeb_tox()}}.
}
\description{
Returns priors calibrated to a specific species using parameter
estimates from the Add-my-Pet (AmP) collection (Marques et al.,
2018).  The log-normal priors are centred on the AmP point estimate
(log scale) with a moderate spread (\eqn{\sigma = 0.3}) that places
95\\% prior mass within approximately \eqn{\pm 80\%} of the AmP
value.
}
\details{
Currently supported species (more will be added):
\describe{
\item{\code{Eisenia_fetida}}{Compost earthworm; AmP entry \code{Eisenia_fetida}.}
\item{\code{Eisenia_andrei}}{Sibling species of \emph{E. fetida}; shares
similar DEB parameters.}
\item{\code{Folsomia_candida}}{Springtail; standard ISO reproduction test species.}
\item{\code{Daphnia_magna}}{Water flea; classic aquatic ecotox model.}
\item{\code{Lumbricus_rubellus}}{Field earthworm; common biomonitoring species.}
}
}
\examples{
# Use AmP-calibrated priors for E. fetida
prior_species("Eisenia_fetida")

# Combine with model specification (R-side, no Stan sampling)
data(eisenia_growth)
dat <- bdeb_data(growth = eisenia_growth[eisenia_growth$id == 1, ])
mod <- bdeb_model(dat, type = "individual",
  priors = prior_species("Eisenia_fetida"))
}
\references{
Marques, G.M., Augustine, S., Lika, K., Pecquerie, L., Domingos, T.
and Kooijman, S.A.L.M. (2018). The AmP project: comparing species on
the basis of dynamic energy budget parameters. \emph{PLOS Computational
Biology}, 14(5), e1006100. \doi{10.1371/journal.pcbi.1006100}
}
