secr (version 3.2.1)

sort.capthist: Sort Rows of capthist or mask Object

Description

Rows are sorted by fields in covariates or by a provided sort key of length equal to the number of rows.

Usage

# S3 method for capthist
sort(x, decreasing = FALSE, by = "",
    byrowname = TRUE,...)
# S3 method for mask
sort(x, decreasing = FALSE, by = "",
    byrowname = TRUE,...)

Arguments

x

capthist object

decreasing

logical. Should the sort be increasing or decreasing?

by

character vector (names of covariates) or data frame whose columns will be used as sort keys

byrowname

logical. Should row name be used as a final sort key?

…

other arguments (not used)

Value

capthist or mask object with sorted rows; any relevant attributes are also sorted (covariates, signal, xy)

Details

For multi-session capthist objects only the named covariate form is suitable as the number of rows varies between sessions.

If requested, rows are sorted by rowname within by. The effect of the defaultsis to sort by rowname.

The attribute markingpoints of a mask object is removed if present, as it is no longer meaningful.

See Also

capthist

Examples

# NOT RUN {
sort(ovenCH, by = "Sex")
covariates(ovenCH)[["2005"]]
covariates(sort(ovenCH, by = "Sex"))[["2005"]]

# }