R/genome.R

Defines functions listGenomes genomeOpt

Documented in genomeOpt listGenomes

# Start of genome.R ############################################################

# genomeOpt --------------------------------------------------------------------
#' Set/get genome option.
#' 
#' This function returns the current value of the \pkg{shmootl} genome option.
#' If a genome is specified, the \pkg{shmootl} genome option is updated with the
#' given value. Call the function \code{\link{listGenomes}} to see available
#' genomes.
#' 
#' @param value New value of genome option.
#' 
#' @return Current value of genome option.
#' 
#' @export
#' @family genome functions
#' @family package option functions
#' @rdname genomeOpt
genomeOpt <- function(value) {
    
    result <- getOption('shmootl.genome', default=const$default$genome)
    
    if ( ! result %in% names(const$seqtab) ) {
        stop("unknown genome - '", result, "'")
    }
    
    if ( ! missing(value) && ! is.null(value) ) {
       
        if ( ! value %in% names(const$seqtab) ) {
            stop("unknown genome - '", value, "'")
        }
        
        options(shmootl.genome=value)
    }
    
    return(result)
}

# listGenomes ----------------------------------------------------------
#' List available genomes.
#' 
#' @return Character vector containing the names
#' of genomes that are available in \pkg{shmootl}.
#' 
#' @export
#' @family genome functions
#' @rdname listGenomes
listGenomes <- function() {
    return( names(const$seqtab) )
}

# End of genome.R ##############################################################
gact/shmootl documentation built on Nov. 11, 2021, 6:23 p.m.