R/histochart.R

In abd: The Analysis of Biological Data

#' Histogram from tabulated data
#' 
#' Uses lattice::barchart() to build a histogram from tabulated data.
#' 
#' This is just a convenience wrapper around lattice::barchart().
#' 
#' @param x formula of form \code{frequency ~ value}
#' @param data data frame in which the formula \code{x} is interpreted
#' @param box.ratio ratio of bar widths to gaps between bars
#' @param origin where do bars begin?
#' @param horizontal Should bars go horizontal?
#' @param \dots other arguments passed to lattice::barchart()
#' @author Randall Pruim (\email{rpruim@@calvin.edu})
#' @keywords graphics
#' @export
#' @examples
#' 
#' histochart( dbinom(0:30, 30, 0.35) ~ 0:30 )
#' 
histochart <- function(x, data=NULL, box.ratio=100, origin=0,
	horizontal=FALSE, ...) 
{
	barchart(x, data, box.ratio=box.ratio, origin=origin,
		horizontal=horizontal, ...)
}