The BrailleR package is a collection of tools to make use of R a happier experience for blind people.
Blind people's use of R
Blind people cannot use RStudio and depending on the combination of operating system and screen reading software we choose to use, we might have differing levels of success with the standard R GUI.
R is perhaps the most blind-friendly statistical software option because all scripts are written in plain text, using the text editor a user prefers, and all output can be saved in a wide range of file formats. The advent of R markdown and other reproducible research techniques can offer the blind user a degree of efficiency that is not offered in many other statistical software options.
Specific objectives of BrailleR
- Make accessing output simpler.
- Gain access to the content depicted in a graph.
- Help get into R markdown easier.
- Replace the tasks other users can do quickly using the RStudio IDE.
You can help
Any assistance to fill in the numerous gaps in what BrailleR delivers will be most gratefully received. As the primary developer of this package is himself blind, attempts to find out if the tools being created actually do replace visual elements or tasks requires a sighted person to sit alongside to offer commentary.
Code of Conduct
Please note that this project is released with a Contributor Code of Conduct. By participating in the BrailleR Project, you are agreeing to this code of conduct. Please check you agree with its terms before participating.
Some issues to resolve:
- storing the graphical parameters in ScatterPlot() etc. does not necessarily get the right ones slected. Need to replace this by somehow keeping the ... arguments supplied by the user. Tested using col and pch in FittedLinePlot()
- Get extra bits of information for WTF() coming through, such as other shapes, lines etc.
- Add to the work done by Debra Warren and Paul Murrell on VI.ggplot() and related functions.
- ascertain which shiny app widgets are useful for blind users' screen reading software.
- link various plot objects to sonify package.
- get more graphics ready for making into SVG for use on Tiger products; mostly in SVGThis() method
- Get more Graph types working with the additional XML to make them interactive.
- fix background of all code chunks in slides being made. This is probably an issue in the css file.
- get graph files named properly by TwoFactors(); including boxplots etc vs each factor not both.
- In OneFactor() and TwoFactors(): ensure that boxplots are created for each factor unless a level is short of reps.
- WTF() doesn't pick up multiple outliers in boxplot() as more than one point
- fix VI.lm to cater for the weighted lm case.
- check the css is working for VI.lm()
- work out how to change colours in R console for low vision users as commands and/or settings
- create function to re-create vignettes from Rnw source into HTML
- Multiple language support was started but is in serious need of some love.
- Functions for the VI method to be completed include: VI.prcomp(), VI.factanal(), VI.glm(), VI.htest()?
- added functionality to compile all Rmd files in the current directory. Request from JYS; initial implementation done in June 2017. Includes batch file for use in Windows explorer and DOS prompt. Needs testing.
- VI.scatterplot() needs creating