dataset_VLE_activity {ouladFormat}R Documentation

Returns the formatted VLE data set based on activity types

Description

Load and formats the student Virtual Learning Environment (VLE) data set from the OULAD for data analysis.

Usage

dataset_VLE_activity(
  module = c("AAA", "BBB", "CCC", "DDD", "EEE", "FFF", "GGG"),
  presentation = c("2013B", "2014B", "2013J", "2014J", "All"),
  repeat_students = c("remove", "keep"),
  week_begin = -4,
  week_end = 39,
  example_data = FALSE
)

Arguments

module

name of the module to be included, either "AAA", "BBB", "CCC", "DDD", "EEE", "FFF" or "GGG".

presentation

name of the semester of the module to be included, either "2013B", "2014B", "2013J", "2014J", or "All". "B" indicates a February start time whereas "J" indicates an October start time. "All" indicates that all presentations of the module will be included in the returned data.

repeat_students

indicator of whether students who had previous attempts at the module should be removed, either "remove" or "keep". If presentation is set to "All", this is automatically set to "remove".

week_begin

the first semester week of VLE data to be included in the formatted data. Depending on the module presentation, students started to view activities up to four weeks prior to the initial module start date. Weeks prior to the initial module start are indicated by a negative integer.

week_end

the last semester week of VLE data to be included in the outputted data. Week 39 is the last week material was viewed (and earlier in some module presentations).

example_data

logical. Indicates whether to run a subset of the data as an example.

Value

Returns two tibbles (objects of class tbl_df) based on the OULAD studentVle.csv and vle.csv files, the specified inputs (module, presentation, and repeat_students), and the range of the weeks included in the tibbles. week_begin and week_end indicates the first and last semester week respectively that is included in the output tibbles. These may be different to the corresponding input parameters. Weeks prior to the initial module start day are indicated by a negative integer. The two tibbles returned are: 1) filtered_data, and 2) resource_data.

filtered_data tibble

A tibble based on the combined oulad files of studentVLE.csv and vle.csv, and the inputs. The tibble consists of (Kuzilek et al., 2017):

resource_data tibble

A tibble where each row represents a unique student and each column their number of interactions with different VLE activity types for the weeks and module presentation inputted.

References

Kuzilek, J., Hlosta, M., & Zdrahal, Z. (2017). Open university learning analytics dataset. Scientific Data volume 4 , (pp. 1–8). https://doi.org/10.1038/sdata.2017.171.

See Also

convert_VLE(), dataset_VLE_time(), VLE_learning_classification() and combined_dataset()

Examples

# Uses subset of the VLE data set for example
dataset_VLE_activity(example_data = TRUE)

# Slow to run as it loads the full VLE data set
dataset_VLE_activity(module = "BBB", presentation = "2013J",
repeat_students = "remove", week_begin = 1, week_end = 13,
example_data=FALSE)

[Package ouladFormat version 1.2.2 Index]