R/reset_index_var.R

Defines functions reset_index_var.zoocat reset_index_var

Documented in reset_index_var reset_index_var.zoocat

#' Reset index variable of a \code{zoocat} object
#' 
#' Reset the index variable of a "\code{zoocat}" object to be one of the fields in 
#' the \bold{cattr} table.
#' 
#' @export
#' @return a "\code{zoocat}" object.
#' @examples 
#' 
#' x <- matrix(1 : 20, nrow = 5)
#' colAttr <- data.frame(month = c(2, 3, 5, 6), name = c(rep('xxx', 3), 'yyy'))
#' zc <- zoocat(x, order.by = 1991 : 1995, colattr = colAttr)
#' print(zc)
#' reset_index_var(zc, 'month')
#' reset_index_var(zc, 'name')
#' 
#' @param x the object.
#' @param ... other arguments.
#' @name reset_index_var
#' @rdname reset_index_var
reset_index_var <- function (x, ...) {
    UseMethod('reset_index_var')
}


#' @export
#' @rdname reset_index_var
#' @param index.var the name of the variable to be set as the index. 
#' Must be one of the \code{cattr} field.
reset_index_var.zoocat <- function (x, index.var, ...) {
    if (index.var == attr(x, 'indname')) {
        return(x)
    } else {
        if (!index.var %in% names(cattr(x))) {
            stop('index.var must be one of the cattr fields.')
        }
        df.melt <- melt(x)
        ret <- cast2zoocat(df.melt, index.var = index.var, value.var = 'value')
        return(ret)
    }
}
ran-ran/zoocat documentation built on July 5, 2017, 8:41 p.m.