VI: Methods to help vision impaired users

Description Usage Arguments Details Value Note Author(s) Examples

View source: R/VIMethod1_JG.R

Description

A set of methods that extract the most relevant information from a graphical object (or implied set of graphical objects) and display the interpreted results in text or HTML form.

The method includes representations of summary methods that are more suitable for blind users. For example, the method for a data.frame uses a single line for each variable instead of the normal column layout used by the summary method.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
Describe(x, VI=FALSE, ...)
VI(x, Describe=FALSE, ...)

## S3 method for class 'histogram'
VI(x, Describe=FALSE, ...)
## S3 method for class 'histogram'
Describe(x, VI=FALSE, ...)

## S3 method for class 'aov'
VI(x, Describe=FALSE, ...)

## S3 method for class 'lm'
VI(x, Describe=FALSE, ...)

Arguments

x

any R object

Describe,VI

Should the other function be called at the same time

...

other arguments, currently ignored

Details

This is the general help page for the VI() functionality. Specific help pages will be created if the ability to alter the outcome through user input warrants. See below for more detail on these.

Describe() is for explaining how a given type of graph appears to the sighted world and is intended for use by blind people who do not know how that graph looks. There is room to add hints for displaying the graphs in a more visually appealing manner. In contrast, VI() is intended to extract the specific details for the particular graph or output concerned.

Further methods can be written by users (blind or sighted). Please submit to the package maintainer for possible inclusion in subsequent releases of the package.

Value

This will vary according to the needs of vision impaired users and the specific objects that need to be interpreted.

In general, the output from VI() is a series of text strings printed in the console/terminal window in addition to the embedded command's normal functionality. The VI.lm() method is the first to move away from this idea and use a process that builds on the UniDesc() function. In this case, the method creates an R markdown file and compiles it into HTML. The HTML document is opened if the R session is interactive.

The VI() functions do not create objects as do many R commands. Manipulations on the objects created by regular R expressions will need those regular expressions issued in addition to those of the VI family of functions. The VI.lm() method does create objects in the current workspace and then deletes them once the HTML document is compiled.

The Describe() family of functions do create an object for passing onto other functions.

Note

The VI.lm method fails if you use the one line VI(lm(...)) even if the model is named using VI(Model1 <- lm(...)). It does work if two explicit commands are used. For example Model1 = lm(...) followed by VI(Model1).

Author(s)

A. Jonathan R. Godfrey and Timothy P. Bilton

Examples

1
2
3
4
5
RandomX=rnorm(500)
PlottedFig=hist(RandomX)
rm(RandomX)
VI(PlottedFig)
rm(PlottedFig)

BrailleR documentation built on June 5, 2018, 9:04 a.m.