lmviz (version 0.2.0)

QuizResidual: QuizResidual shiny app

Description

Launches the QuizResidual shiny app

Usage

QuizResidual(
  ComputerDecision = ComputerDecision.default,
  Simulation = Simulation.default,
  dir.images = NULL,
  dir.sounds = NULL
)

Arguments

ComputerDecision

the function to be used to state the answer of the computer player (see ComputerDecision.default)

Simulation

the function to be used to simulate data (see Simulation.default)

dir.images

the directory where images to be used by the shiny app are to be found, default to NULL, images from the package will be used

dir.sounds

the directory where sounds to be used by the shiny app are to be found, default to NULL, sounds from the package will be used

Value

None

Details

QuizResidual shiny app is a game in which the player is asked to guess, based on four standard diagnostic plots of a linear model, whether there is a violation of one of the basic assumptions: linearity, homoscedasticity, normality of errors.

The program will simulate a sample (x,Y) from a randomly chosen data generating mechanism possibly violating one of the assumptions (function Simulation.default), fit a linear model and plot the diagnostic.

The computer player makes a guess on whether there is a violation of assumptions (function ComputerDecision.default).

After the answer is given, the true data generating mechanism will be shown in the plot, in particular, the true regression function, the true standard deviation of errors and the true density of errors.

The game can be customized by coding your own Simulation and ComputerDecision functions passing them as arguments.

Sounds will be played depending on whether the correct or wrong answer is given and a final sound is played depending on the outcome, also an appropriate image is shown. (Sounds are taken from the site https://freesound.org/, images from https://wpclipart.com and are public domain, other sounds and images can be used by calling the app with the directories where the images are stored as argument, sounds must be named as follows: suonorr: sound to be played when both the player and the computer give the correct answer; suonowr: sound to be played when the player is correct and the computer is wrong; suonorw and suonoww are analogous; suonofinaleP/V/S: final sound to play in case of tie/win/loss; immagineP/V/S: image to be shown in case of tie/win/loss.)

See Also

ComputerDecision.default, Simulation.default

Examples

# NOT RUN {
## Not run:
if (interactive()){
  QuizResidual()
  # if custom sounds and images are in the directory www in the working directory
  QuizResidual(dir.images=paste0(getwd(),"/www"),dir.sounds=paste0(getwd(),"/www"))
}
## End(Not run)

# }