README.md
In NicolasJBM/genexam: Creation and Generation of Exams

genexam

genexam is a package I designed to help teachers perform four distinct sets of tasks:

generate exam (multiple choice or open questions);
gather in a single database information about questions, students, solutions, and answers;
check and analyse results across students and questions;
create and send individual reports to students.

Each tasks is handled by a specific shiny gadget I will desribe hereafter.

To use the package, several complementary pieces of (free) software must be installed on your computer. Here are the links towards the installation files:

Software Windows Mac.OS.X R R for Windows R for mac OS X Rtools RTools - RStudio RStudio RStudio Latex Miktex Texlive Pdf pdftk pdftk Images imagemagik imagemagik perl perl -

In addition, you also need to have a package containing the templates of questions to be used for the exams. I created the package manacc for a management accounting course. You can install this package by typing the following lines of code in the R console:

install.packages("devtools")
devtools::install_github("NicolasJBM/manacc")

The package genexam is only available under its development version. You can install it from Github by typing in the R console the following lines of code:

# install.packages("devtools")
devtools::install_github("NicolasJBM/genexam")

Once the package installed, you can start using the functions.

There are four main functions in genexam:

genexam() is a shiny gadget to select questions, assign points, and generate the exam;
gradexam() is a shiny gadget to gather information about questions, solutions, and students, scan the answers, and build a complete database;
checkexam() is a shiny gadget to analyse the results of exams stored in the database created by gradexam();
sendexam() is a shiny gadget to create individual reports based on the results and send them to the students.

In addition, there are also a few supporting functions:

int(), dbl(), and pct() format numbers respectively as integers, doubles, or percentages;
genexam_param_quest() is a function embedded in question templates to retrieve information necessary for their generation;
genexam_make_scan_A4() is on exam2nops() from the exams package and create answer sheets;
genexam_simulate() simulate answers to test the package.

Finally, a template of exam helps structuring the use of the package:

a markdown template is used to create the folder in which exams will be generated and stored;
a rstudio addin file places the four main functions in the rstudio interface.