showData {relimp}R Documentation

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")

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

Value

invisible(NULL)

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, d.firth@warwick.ac.uk

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)

[Package relimp version 0.9-5 Index]