`warn`

estimates weaning parameters (i.e., weaning ages, enrichment factor, and nitrogen isotope ratio (d15N) of weaning food derived collagen) for a given skeletal population under the flamework of approximate Bayesian computation (ABC).

1 2 3 4 5 |

`age` |
a vector of estimated ages in year of the non-adult skeletons. Ages greater than 10 years are not allowed. |

`d15N` |
a vector of bone collagen d15N of non-adult skeletons. |

`prior` |
a vector of hyper parameter values for prior distributions of the weaning parameters. Mean and SD for t1 (age at the start of weaning), t2 (age at the end of weaning), enrichment of d15N, and d15N of weaning food derived collagen, in sequence. The values are succeeded to |

`female.mean` |
the mean d15N of the adult females, single value. |

`female.sd` |
the one standard deviation of adult female d15Ns, an optional single value. Utilized later in |

`num.particle` |
number of particles in sequential Monte Carlo (SMC) sampling; defaults to 10000. |

`form` |
form of the model curve for the weaning process. The allowed values are |

`tolerances` |
a vector of decreasing torelances used in the SMC sampling. The default is |

The `warn`

esimates the age at the start and end of weaning, enrichment of d15N through maternal to infant tissue, and d15N value of collagen synthesized entirely from weaning foods with their posterior probabilities. Probabilities are estimated by SMC with partial rejection control, and the algorithm was derived from Sisson et al. (2007, 2009). The posterior probabilities are obtained as a result of kernel density estimation, a product of `kde2d`

in MASS package for weaning ages, and `density`

for enrichment and weaning foods. The model used to describe the change in d15N during weaning contains a new estimate of bone collagen turnover rates in non-adults, and is shown in Tsutaya and Yoneda (2013).

`warn`

returns an object of `class`

`"warn"`

.

The function `summary`

and `plot`

are used to obtain and indicate a summary and figure of the results, respectively.

An object of class `"warn"`

is a list containing at least the following components:

`mde` |
the maximum density estimators and their marginal probabilities for the weaning parameters. |

`prob.2d.age` |
the joint probability for combination of the maximum density weaning ages. |

`dist.mde` |
the mean squared distance between the measured and modeled d15Ns of non-adults. |

`kde.age` |
two-dimensional kernel density estimates of the weaning ages. A product of |

`kde.enrich` |
kernel density estimates of the enrichment factor from mother to infant. A product of |

`kde.wnfood` |
kernel density estimates of the d15N of collagen synthesized entirely form weaning foods. A product of |

`posterior` |
a matrix of final particles in SMC sampling. |

`age` |
the non-adult ages used. |

`d15N` |
the measuerd d15Ns of non-adult bone collagen used. |

`female.mean` |
the mean d15N of adult females used. |

`female.sd` |
the one standard deviation of adult female d15Ns used. |

`prior` |
a vector of the hyper parameter values for the prior distributions used. |

`particle` |
the number of particles used. |

`form` |
the form of the model curve used. |

`call` |
the matched call. |

The band-width of kernel density estimation (i.e., `h`

in `kde2d`

and `bw`

in `density`

) is selected by SJ method, `width.SJ`

in MASS, with "direct plug-in".

Takumi Tsutaya developed this model.

Sisson, S. A., Fan, Y., and Tanaka, M. M. (2007, 2009). Sequential Monte Carlo without likelihoods. *Proc. Natl. Acad. Sci.* **104**, 1760–1765.

Tsutaya, T., and Yoneda, M. (2013). Quantitative reconstruction of weaning ages in archaeological human populations using bone collagen nitrogen isotope ratios and approximate Bayesian computation. *PLoS ONE* **8**, e72327.

`WARN`

, `warnCI`

, `warnProb`

, `summary.warn`

, `plot.warn`

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 | ```
## Data from the Lerna population.
nonadult <- subset(lerna, lerna$age <= 10)
adult <- subset(lerna, lerna$age > 17)
female <- subset(adult, adult$sex == "f")
## Calculate maximum density estimators using ABC.
warn.lerna <- warn(
age = nonadult$age,
d15N = nonadult$d15N,
female.mean = mean(female$d15N),
num.particle = 500,
female.sd = sd(female$d15N),
prior = c(0.2, 0.5, 1.6, 0.5, 2.5, 0.5, 8.1, 0.5),
tolerances = c(1.5, 0.7))
## Indicate summary.
summary(warn.lerna)
## Plot.
plot(warn.lerna)
## Plot with adult mean.
plot(warn.lerna,
hline.adult = TRUE,
adult.mean = mean(adult$d15N),
adult.sd = sd(adult$d15N),
is.female = FALSE)
``` |

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at ian@mutexlabs.com.

All documentation is copyright its authors; we didn't write any of that.