Import and Analysis of OMR Data from FormScanner
Import data of tests and questionnaires from FormScanner. FormScanner is an open source software that converts scanned images to data using optical mark recognition (OMR) and it can be downloaded from http://sourceforge.net/projects/formscanner/. The spreadsheet file created by FormScanner is imported in a convenient format to perform the analyses provided by the package. These analyses include the conversion of multiple responses to binary (correct/incorrect) data, the computation of the number of corrected responses for each subject or item, the computation and the graphical representation of the frequencies of the responses to each item and the report of the responses of one or a few persons.
|License:||GPL (>= 2)|
Data of questionnaires and tests are often collected on paper forms.
FormScanner is an open source software that converts scanned images
to data using optical mark recognition (OMR).
read.formscanner of the fsia package
can be used to import data from FormScanner in R.
If items have a correct response (key), data can be converted
in binary variables using function
In this case, the number of corrected responses for each person
and for each item can also be computed by using functions
freq calculates the absolute or percentage
frequencies of the responses to each item. The frequencies can
be printed on screen or plotted on a graph. In both cases, the
true responses (if any) are highlighted.
The responses given by one or a few persons can be displayed
on a graph by using function
The key is shown on the right and wrong responses can be immediately
identified by the red colour.
The package includes various data sets for illustrative purposes.
The examples given in the documentation of function
export these data in the same format of FormScanner and then
import the files created.
contain simulated multiple choice responses to 30 items and present
10 items in common.
contain the same data of
with the only exception that the identifier of the persons
can be obtained by concatenating a set of columns of the data set.
key contains the correct responses of the
items of all data sets of the fsia package.
exam1 is an instance of the output of
read.formscanner and contains the data
mchoice1 and the corresponding key.
Maintainer: Michela Battauz <firstname.lastname@example.org>
Borsetta, A. (2014). FormScanner [Computer Software], URL http://sourceforge.net/projects/formscanner/.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
## Not run: # IMPORT DATA FROM FORMSCANNER # in this example # the identification number is in column "File name" # and the key is given in a separate file data(mchoice1) data(key) # NOTE: the following line creates a file with the same format of FormScanner write.csv2(mchoice1, "mchoice1.csv", row.names = FALSE) # NOTE: the following line creates a file with the key write.csv2(key, "key.csv", row.names = FALSE) fs1 <- read.formscanner(file = "mchoice1.csv", keyfile = "key.csv", id = "File.name") head(fs1$data) fs1$key # fs1 is equal to the data set exam1 ## End(Not run) data(exam1) # CONVERT DATA IN BINARY VARIABLES exam1bin <- resp2binary(obj = exam1, col = 2:31) # PERSON STATISTICS pst <- person.stat(obj = exam1, col = 2:31) head(pst) summary(pst$score) hist(pst$score, main = "Histogram of Scores", xlab = "") # ITEM STATISTICS item.stat(obj = exam1, col = 2:31) # FREQUENCIES OF THE RESPONSES fr <- freq(obj = exam1, col = c("I2","I3")) fr plot(fr) # RESPONSES OF TWO PERSONS report(obj = exam1, col = 2:31, whichid = c("101844", "101272"))