fsia (version 1.0)

fsia-package: Import and Analysis of OMR Data from FormScanner

Description

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.

Details

Package:

fsia

Type:

Package

Version:

1.0

Date:

2015-01-13

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). Function 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 resp2binary. In this case, the number of corrected responses for each person and for each item can also be computed by using functions person.stat and item.stat. Function 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 report. 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 read.formscanner export these data in the same format of FormScanner and then import the files created. Data sets mchoice1 and mchoice2 contain simulated multiple choice responses to 30 items and present 10 items in common. Data sets mchoice1id and mchoice2id contain the same data of mchoice1 and mchoice2 with the only exception that the identifier of the persons can be obtained by concatenating a set of columns of the data set. Data set key contains the correct responses of the items of all data sets of the fsia package. Data set exam1 is an instance of the output of function read.formscanner and contains the data mchoice1 and the corresponding key.

References

Borsetta, A. (2014). FormScanner [Computer Software], URL http://sourceforge.net/projects/formscanner/.

Examples

## 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"))