txtplot: Ascii graphics

In txtplot: Text Based Plots

Description

Provides a function to produce rudimentary ascii graphics directly in the terminal window.

txtplot provides the basic plotting function of two numeric vectors. All other functions below are based on this.
txtcurve is a text based equivalent of the curve function
txtdensity is a text based density estimation function based on the density function
txtacf is a text based equivalent of the acf function and based on the acf function.
txtbarchart is a text based barplot and plots the relative frequences of the occurences of the different levels of a factor (in percent)

Usage

txtplot(x, y = NULL, pch = "*", width = round(options()$width*0.8),
        height = round(0.25*width), xlab = NULL, ylab = NULL,
        xlim = NULL, ylim = NULL)

txtcurve(expr, from = NULL, to = NULL, n = 101,
         pch = "*", width = round(options()$width*0.8),
         height = round(0.25*width), xlab = NULL, ylab = NULL)

txtdensity(x, pch = "*", width = round(options()$width*0.8),
        height = round(0.25*width), xlab = NULL, ylab = NULL)

txtacf(x, pch = "*", lag.max = 20, type = c("correlation", "covariance", "partial"),
       na.action = na.fail, demean = TRUE, width = round(options()$width*0.8),
       height = round(0.25*width), xlab = NULL, ylab = NULL)

txtbarchart(x, pch = "*", width = round(options()$width*0.8),
            height = round(0.25*width), ylab = NULL)

Arguments

x	numeric containing the x-values to plot (for txtbarchart this needs to be of class factor). NA, NaN are removed for plotting. Infinities cause an error
y	numeric containing the x-values to plot (needs to be of the same length as x). If NULL the numeric x is plotted against 1:length(x). NA, NaN are removed for plotting. Infinities cause an error
pch	Plotting symbol
width, height	Width and height of the plots in points
xlab, ylab	labels for x and y axis
xlim, ylim	limits for x and y axis in plot, if equal to NULL automatically determined from x and y.
expr	An expression to plot (containing x)
from,to	Defines boundaries of plotting region for expr in txtcurve
n	integer specifying the number of x values between from and to
lag.max, type, na.action, demean	arguments for call of acf function, see ?acf for details

Note

Due to rounding to a relatively crude grid results can only be approximate! The equally spaced axis ticks, for example, may be non-equally spaced in the plot.

Due to the crude grid also there might be several points per pixel. The function uses the same plotting symbol no matter how many points coincide on one pixel

Author(s)

Bjoern Bornkamp

See Also

txtboxplot

Examples

  ## basic plotting function
  require(stats)
  txtplot(cars[,1], cars[,2])
  ## can include axis labels when desired
  txtplot(cars[,1], cars[,2], xlab = "speed", ylab = "distance")

  ## text based density plot
  txtdensity(rnorm(500))

  ## text based plotting of functions
  txtcurve(x/(x+1), 0, 4, xlab = "Emax model")

  ## text based acf
  txtacf(rnorm(100))

  ## text based barchart
  x <- factor(c("orange", "orange", "red", "green", "green", "red",
               "yellow", "purple", "purple", "orange"))
  txtbarchart(x)

  ## text based boxplots
  rand1 <- rnorm(100, 1, 2)
  rand2 <- rnorm(50, 2, 2)
  rand3 <- rnorm(50, 2, 5)
  txtboxplot(rand1)
  txtboxplot(rand1, rand2, rand3)

txtplot documentation built on April 5, 2020, 9:07 a.m.