dataset_VLE_time {ouladFormat}R Documentation

Returns the formatted VLE data set for daily and weekly counts

Description

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

Usage

dataset_VLE_time(
  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 formatted data. Depending on the module presentation, students started to view activities 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 formatted 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 three tibbles (objects of class tbl_df) based on the OULAD studentVle.csv file, 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 input parameters of week_begin and week_end. Weeks prior to the initial module start day are indicated by a negative integer. The three tibbles returned are: 1) filtered_data, 2) daily_data, and 3) weekly_data.

filtered_data tibble

A tibble based on the students' VLE interactions and the inputs. The tibble consists of (Kuzilek et al., 2017):

daily_data tibble

A tibble where each row represents a unique student, and each column their number of interactions with the VLE for different days of the module. The module starts on day 0. Days prior to the initial start day, are indicated by negative integers.

weekly_data tibble

A tibble where each row represents a unique student, and each column their number of interactions with the VLE for different weeks of the module. Weeks prior to the initial start week (week 1) are indicated by the term 'pre' in the week name.

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_activity(), and combined_dataset()

Examples

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

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

[Package ouladFormat version 1.1.2 Index]