[This article was first published on
R/exams, and kindly contributed to
R-bloggers]. (You can report issue about the content on this page
here)
Want to share your content on R-bloggers?
click here if you have a blog, or
here if you don't.
1. R
The R/exams system is an extension for the
R system for statistical computing and hence the
first installation step is the base R system.
- Windows and (Mac) OS X: Go to https://CRAN.R-project.org/, the
Comprehensive R Archive Network (CRAN). Simply
click on the link for your operating system and at least install the “base”
system. It is recommended to also install the accompanying “Rtools” which are
not needed immediately but might useful at some stage.
-
Linux: While it is possible to download from CRAN by hand, it is
easier for most distributions to install the packaged binary. For example,
on Debian/Ubuntu:
apt-get install r-base-core r-base-dev
There is a wide variety of interfaces for using R including simply the shell,
Emacs, or dedicated graphical user interfaces for Windows and OS X, respectively.
Moreover, RStudio is an open-source cross-platform integrated development
environment that facilitates many common tasks for R beginners.
2. R package “exams”
The core of R/exams is the open-source R package
“exams”, also available from CRAN.
It can be easily installed interactively from within R with a single command.
If necessary, the development version of the package is also available, which
may provide some new features or small improvements.
Development version:
install.packages("exams", repos = "http://R-Forge.R-project.org")
Details: Several additional R packages, automatically installed by the command above,
are needed for certain tasks: base64enc (HTML-based output: Base64 encoding of
supplements), knitr (R/Markdown-based exercises), png (NOPS exams: reading
scanned PNG images), RCurl (ARSnova: posting exercises), RJSONIO (ARSnova:
JSON format), rmarkdown (pandoc-based conversion), tth (HTML output from
R/LaTeX exercises).
3. LaTeX
For producing PDF output, the typesetting system LaTeX is used internally by R/exams.
- Windows: Go to http://www.MikTeX.org/ and click on “Download” to obtain
the MikTeX distribution for Windows.
- (Mac) OS X and Linux: LaTeX distributions are available in the standard
repositories and can be installed in the “usual” way, typically using the
TeX Live distribution.
4. Pandoc
For certain conversions performed internally in R/exams, specifically when
Markdown is involved, the universal document converter
pandoc is employed. If you have installed RStudio, then
pandoc is provided along with it and nothing else needs to be done.
Otherwise pandoc can be obtained from its web page (linked above) or standard repositories,
e.g., for Debian/Ubuntu:
apt-get install pandoc
Note: Unless you want to process written NOPS exams
from scanned PDF files, this section can be skipped.
If the scanned images of written NOPS exams (from your photocopier) are in PDF format,
they need to be converted to PNG first using the PDF Toolkit pdftk and
ImageMagick’s convert.
- Windows: Install PDFTk Free, ImageMagick, and Ghostscript.
-
Linux: Install PDFTk and ImageMagick from your distribution, e.g., for Debian/Ubuntu:
apt-get install pdftk imagemagick
To check that the software from Steps 1-4 works, try to run some examples from the
exercise template gallery, e.g., dist or
ttest.
