GIFTr v0.1.0

0

Monthly downloads

0th

Percentile

GIFT Questions Format Generator from Dataframes

A framework and functions to create 'MOODLE' quizzes. 'GIFTr' takes dataframe of questions of four types: multiple choices, numerical, true or false and short answer questions, and exports a text file formatted in 'MOODLE' GIFT format. You can prepare a spreadsheet in any software and import it into R to generate any number of questions with 'HTML', 'markdown' and 'LaTeX' support.

Readme

GIFTr

Travis build
status AppVeyor build
status DOI

‘GIFTr’ package in intended to help course creators to upload questions to MOODLE and other LMS for quizzes. ‘GIFTr’ takes dataframe or tibble of questions of four types: mcq, numerical questions, true or false and short answer,and export it a text file formatted in MOODLE GIFT format. You can prepare a spreadsheet in any software and import it in R and generate any number of questions with HTML, markdown and LATEX support.

Installation

from GitHub with:

# install.packages("devtools")
devtools::install_github("omarelashkar/GIFTr" , build_vignettes = TRUE)

Example

library(GIFTr)
# load GIFTrData
data("GIFTrData")

# See the structure of the data
head(GIFTrData , 2)
#>   categories names                                          question
#> 1  Ques/hist    Q1                 Who's buried in **Grant's tomb**?
#> 2  Ques/hist    Q2 What two people are entombed in **Grant's tomb?**
#>        A
#> 1 *Grant
#> 2 No one
#>                                                                                   B
#> 1 no one#Was true for 12 years, but Grant's remains were buried in the tomb in 1897
#> 2                                                                            *Grant
#>                                  C                                  D
#> 1 Napoleon#He was buried in France Churchill#He was buried in England
#> 2                    *Grant's wife                     Grant's father
#>                                       E question_type
#> 1 Mother Teresa#She was buried in India           mcq
#> 2                                  <NA>           mcq
str(GIFTrData)
#> 'data.frame':    11 obs. of  9 variables:
#>  $ categories   : chr  "Ques/hist" "Ques/hist" "Ques/hist" "Ques/science" ...
#>  $ names        : chr  "Q1" "Q2" "Q3" "Q4" ...
#>  $ question     : chr  "Who's buried in **Grant's tomb**?" "What two people are entombed in **Grant's tomb?**" "Grant was buried in a tomb in New York City" "The sun rises in the West." ...
#>  $ A            : chr  "*Grant" "No one" "T" "F" ...
#>  $ B            : chr  "no one#Was true for 12 years, but Grant's remains were buried in the tomb in 1897" "*Grant" NA NA ...
#>  $ C            : chr  "Napoleon#He was buried in France" "*Grant's wife" NA NA ...
#>  $ D            : chr  "Churchill#He was buried in England" "Grant's father" NA NA ...
#>  $ E            : chr  "Mother Teresa#She was buried in India" NA NA NA ...
#>  $ question_type: chr  "mcq" "mcq" "tf_q" "tf_q" ...

#Create quiz.txt file with GIFT format 
GIFTr::GIFTr(data = GIFTrData, questions = 3, answers = c(4:8), 
             categories = 1, question_type = 9, output = 'quiz.txt')
#> Total Number of Questions passed: 11
#> 
#> ====
#> ====
#> ====
#> ====
#> MCQ questions input count: 2 
#> MCQ questions with single answer passed: 1 
#> MCQ questions with multiple answers passed: 1 
#> Error found: 0 
#> No valid question found : 0 
#> No valid answer found: 0
#> 
#> ====
#> ====
#> ====
#> Done MCQ!
#> ===
#> Numerical questions input count: 5 
#> Numerical questions with single answer passed: 4 
#> Numerical questions questions with multiple answers passed: 1 
#> Error found: 0 
#> No valid question found : 0 
#> No valid answer found: 0
#> 
#> ====
#> ====
#> ====
#> Done Numerical questions!
#> ====
#> total short answer questions passed is 2. 
#> Valid answer: 2 
#> error in 0 
#> 0 no question has been found 
#> 0 no valid answer has been found
#> 
#> ====
#> ====
#> ====
#> Done Short Answer questions!
#> ====
#> T/F questions passed input: 2 
#> T/F questions Passed: 2 
#> Error found: 0 
#> No question found : 0 
#> No valid answer found: 0
#> 
#> ====
#> ====
#> ====
#> Done T/F questions!
#> ====

The generated file can be imported easily by MOODLE or any other LMS that supports GIFT.

For further documentation instructions, check the package vignette and documentation.

#open vingette
vignette("GIFTr_tutorial")

Functions in GIFTr

Name Description
mcq Generate GIFT MCQs From Spreadsheet
GIFTrData_2 Questions Data without asterisk
num_q Generate GIFT Numeric Questions From Spreadsheet
short_ans Generate 'GIFT' Short Answer From Spreadsheet
GIFTr Generate A GIFT File of Different Question Types From a Spreadsheet
GIFTrData Questions Data with asterisk and multiple answer mcq
tf_q Generate GIFT True or False Questions From Spreadsheet
No Results!

Vignettes of GIFTr

Name
GIFTr_tutorial.Rmd
No Results!

Last month downloads

Details

Type Package
License GPL-3
Encoding UTF-8
LazyData true
RoxygenNote 6.1.1
URL https://github.com/omarelashkar/GIFTr
VignetteBuilder knitr
NeedsCompilation no
Packaged 2019-10-16 17:33:13 UTC; xxxmar
Repository CRAN
Date/Publication 2019-10-20 11:30:05 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/GIFTr)](http://www.rdocumentation.org/packages/GIFTr)