Chronological Apportioning

## Usage

```
apportion(object, ...)
# S4 method for data.frame
apportion(
object,
s0,
s1,
t0,
t1,
from = min(s0),
to = max(s1),
step = 25,
method = c("uniform", "truncated"),
z = 2,
progress = getOption("kairos.progress")
)
# S4 method for matrix
apportion(
object,
s0,
s1,
t0,
t1,
from = min(s0),
to = max(s1),
step = 25,
method = c("uniform", "truncated"),
z = 2,
progress = getOption("kairos.progress")
)
```

## Arguments

- object
A \(m \times p\)

`numeric`

`matrix`

or`data.frame`

of count data (absolute frequencies giving the number of individuals for each category, i.e. a contingency table). A`data.frame`

will be coerced to a`numeric`

`matrix`

via`data.matrix()`

.- ...
Currently not used.

- s0
A length-\(m\)

`numeric`

vector giving the site beginning dates expressed in CE years (BCE years must be given as negative numbers).- s1
A length-\(m\)

`numeric`

vector giving the site end dates expressed in CE years (BCE years must be given as negative numbers).- t0
A length-\(p\)

`numeric`

vector giving the type beginning dates expressed in CE years (BCE years must be given as negative numbers).- t1
A length-\(p\)

`numeric`

vector giving the type end dates expressed in CE years (BCE years must be given as negative numbers).- from
A length-one

`numeric`

vector giving the beginning of the period of interest (in years CE).- to
A length-one

`numeric`

vector giving the end of the period of interest (in years CE).- step
A length-one

`integer`

vector giving the step size, i.e. the width of each time step for apportioning (in years CE; defaults to \(25\)).- method
A

`character`

string specifying the distribution to be used (type popularity curve). It must be one of "`uniform`

" (uniform distribution) or "`truncated`

" (truncated standard normal distribution). Any unambiguous substring can be given.- z
An

`integer`

value giving the lower and upper truncation points (defaults to \(2\)). Only used if`method`

is "`truncated`

".- progress
A

`logical`

scalar: should a progress bar be displayed?

## Value

A `CountApportion`

object.

## References

Roberts, J. M., Mills, B. J., Clark, J. J., Haas, W. R., Huntley, D. L. &
Trowbridge, M. A. (2012). A Method for Chronological Apportioning of Ceramic
Assemblages. *Journal of Archaeological Science*, 39(5): 1513-20.
doi:10.1016/j.jas.2011.12.022
.