mark.dist {windex}

Summarising distributions of (exam/coursework/etc.) marks for (UK) university teaching

Description

Provides a breakdown of marks including summary statistics, plotted histogram with test of Normality, and distribution of grades (for UK system, i.e. 1st, 2.1, 2.2, 3rd, fail). Note that grading system is assumed to be out of 100 and grade boundaries are assumed to be 40 (from fail to 3rd), 50 (from 3rd to 2.2), 60 (from 2.2 to 2.1), and 70 (from 2.1 to 1st).

Usage

mark.dist(marks,plot=TRUE,col="light grey",main=NULL,xlab="Marks",xlim=c(0,100),
showBounds=FALSE,y=20,digits=2,...)

Arguments

marks

Numerical vector containing the marks being summarised.

plot

A logical indicating whether to plot a histogram of mark distribution.

col

Fill colour for histogram, passed to hist().

main

Title for histogram, passed to hist().

xlab

Text for x-axis label of histogram, passed to hist().

xlim

Numerical vector of length 2 giving start and end points of x-axis of histogram, passed to hist().

showBounds

A logical which, if TRUE, adds dashed lines and text to the histogram illustrating grade boundaries.

y

If showBounds=TRUE, y gives the height to plot the text on the histogram (this will likely need tweaked for each case).

digits

Number of digits to round values in grade breakdown table, default gives proportions to a precision of 1

...

Additional arguments passed to hist() to customise the histogram.

Value

Summary

Summary statistics of the mark distribution

NormalityTest

Results of Shapiro-Wilk normality test

GradeBreakdown

Proportion of marks falling into each grade

Author(s)

Kevin Arbuckle

Examples

testscores<-rnorm(n=85,mean=60,sd=15)
mark.dist(testscores)