mark.dist: Summarising distributions of (exam/coursework/etc.) marks for...

In kevinarbuckle/windex: Analysing Convergent Evolution using the Wheatsheaf Index

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)

kevinarbuckle/windex documentation built on Feb. 9, 2025, 7:03 p.m.