Installation
This package is still in the early stages of development and currently is only available from GitHub. To install the development version run the following:
# install.packages("devtools")
devtools::install_github("rundel/learnrhash")Usage
This package is meant to provide addition tools for collection student answers to learnr tutorials. The package does not transmit the answers in any way, but instead provides a convenient method to generate a compressed text based representation that can be easily copied and pasted. The students can then submit these solutions by pasting this “hash” into an online web form (e.g. Google Forms, Microsoft Forms, etc.) or a learning management system quiz or assignment tool.
To enable this functionality, all you need to do is include the following in a learnr Rmd document:
## Submit
```{r context="server"}
learnrhash::encoder_logic()
```
```{r encode, echo=FALSE}
learnrhash::encoder_ui()
```which results in the Submit topic appearing in the tutorial with all of the necessary shiny logic and ui inserted, as shown below.
Encode solutions
In the example above a url for http://localhost given, this value can be replaced with whatever link you would like to use for submission. All the students will need to do is to paste the generated hash into a text response field on whatever web form you choose to use.
Working with Hashes
The expectation is that after students submit their solutions you will be able to obtain some tabular representation of these results that can be read into R as a data frame. The package includes a simple example of this type of data which is loaded as follows
example = readRDS(system.file("example.rds", package="learnrhash"))
example## # A tibble: 2 × 3
## student student_id hash
## <chr> <dbl> <chr>
## 1 Colin 20000 QlpoOTFBWSZTWeVuJ2oAA0d/gP/7aAhoC7BViyIOyr/v/+BAAcACsAS7C1…
## 2 Mine 10000 QlpoOTFBWSZTWYeyPVYAA0x/gP/7aAhoC7BVgyIOyr/v/+BAAcACsAdqC1…Currently the package provides two functions for extracting question solutions and exercise solutions from these hashed data, for both functions the only required argument is the name of the column containing the hashed solutions
To extract the all submissions use,
learnrhash::extract_hash(example)## # A tibble: 10 × 5
## student student_id id type data
## <chr> <dbl> <chr> <chr> <list>
## 1 Colin 20000 code exercise_submission <named list [4]>
## 2 Colin 20000 code2 exercise_submission <named list [4]>
## 3 Colin 20000 details question_submission <named list [4]>
## 4 Colin 20000 not_a_planets question_submission <named list [4]>
## 5 Colin 20000 planets question_submission <named list [4]>
## 6 Mine 10000 code exercise_submission <named list [4]>
## 7 Mine 10000 code2 exercise_submission <named list [4]>
## 8 Mine 10000 details question_submission <named list [4]>
## 9 Mine 10000 not_a_planets question_submission <named list [4]>
## 10 Mine 10000 planets question_submission <named list [4]>and to get just the exercises,
learnrhash::extract_exercises(example)## # A tibble: 4 × 5
## student student_id id type data
## <chr> <dbl> <chr> <chr> <list>
## 1 Colin 20000 code exercise_submission <named list [4]>
## 2 Colin 20000 code2 exercise_submission <named list [4]>
## 3 Mine 10000 code exercise_submission <named list [4]>
## 4 Mine 10000 code2 exercise_submission <named list [4]>or questions,
learnrhash::extract_questions(example)## # A tibble: 6 × 5
## student student_id id type data
## <chr> <dbl> <chr> <chr> <list>
## 1 Colin 20000 details question_submission <named list [4]>
## 2 Colin 20000 not_a_planets question_submission <named list [4]>
## 3 Colin 20000 planets question_submission <named list [4]>
## 4 Mine 10000 details question_submission <named list [4]>
## 5 Mine 10000 not_a_planets question_submission <named list [4]>
## 6 Mine 10000 planets question_submission <named list [4]>If you would like to experiment with this decoding and extraction while writing your tutorial you can also include decoding logic and ui elements into the tutorial in a similar way that the encoder was included. Simply add the following lines into your Rmd,
## Decode
```{r context="server"}
learnrhash::decoder_logic()
```
```{r encode, echo=FALSE}
learnrhash::decoder_ui()
```
Decode solutions
