showData: Display a Data Frame in a Tk Text Widget

In relimp: Relative Contribution of Effects in a Regression Model

Description

Displays the contents of a data frame in a modeless Tk text window, for inspection. Objects not of class data.frame, for example objects of class table, or matrix, are coerced using as.data.frame prior to display.

Usage

showData(dataframe, 
       colname.bgcolor = "grey50", 
       rowname.bgcolor = "grey50", 
       body.bgcolor = "white", 
       colname.textcolor = "white", 
       rowname.textcolor = "white", 
       body.textcolor = "black",
       font = "Courier 12", 
       maxheight = 30, 
       maxwidth = 80, 
       title = NULL,
       rowname.bar = "left",
       colname.bar = "top",
       rownumbers = FALSE, 
       placement = "-20-40",
       suppress.X11.warnings = TRUE)

Arguments

dataframe	A data frame, or an object to which as.data.frame() can be validly applied
colname.bgcolor	A background colour for the variable-names panel
rowname.bgcolor	A background colour for the row-names panel
body.bgcolor	A background colour for the data
colname.textcolor	A colour for the variable names
rowname.textcolor	A colour for the row names
body.textcolor	A colour for the data
font	The text font used – should be a monospaced font
maxheight	The maximum number of rows to display
maxwidth	The maximum width of display, in characters
title	A title for the window. Default is to use the name of the dataframe as given in the call to showData()
rowname.bar	position of sidebar for row names, "left" or "right", or c("left","right"), or NULL
colname.bar	position of column names, "top" or "bottom", or c("top","bottom"), or NULL
rownumbers	logical, whether row numbers should be displayed
placement	Position of the bottom right corner of the window
suppress.X11.warnings	logical, if TRUE then any X11 warnings are suppressed

Value

Invisibly returns the Tk window containing the displayed data frame.

Note

An error results if the printed representation of dataframe exceeds the maximum allowed width of 10000 characters; see options.

Text can be copied from the Tk window to the system clipboard, using <Control-C> or via a right-click pop-up menu.

On some systems the window may take a few seconds to appear if the data frame is very large.

Author(s)

David Firth, [e-mail]; with Rcmdr-specific features contributed by John Fox

Examples

## This cannot be run by example() but should be OK when pasted
## into an interactive R session
## Not run: 
data(mtcars)
showData(mtcars)
## End(Not run)

relimp documentation built on May 2, 2019, 2:02 p.m.