showData {relimp}

Display a Data Frame in a Tk Text Widget

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)