Skip to contents

Zoom Class Students Summary

class_students.Rd

class_students() was designed to retrieve time information about each students in Zoom's classroom at given time period. Input of this function (data) is a zoom_participants object as returned by read_participants().

Usage

class_students(
  data,
  class_start = NULL,
  class_end = NULL,
  late_cutoff = NULL,
  period_to = c("period", "second", "minute", "hour"),
  round_digits = NULL
)

Arguments

data

A data frame (tibble) with class zoom_participants

class_start

(Character) The time of class started, input as "hh:mm:ss" or "hh:mm". If NULL (default) and zoom_participants has meeting_overview attribute, "Start_Time" of the attribute will be used.

class_end

(Character) The time of class ended, input as "hh:mm:ss" or "hh:mm". If NULL (default) and zoom_participants has meeting_overview attribute, "End_Time" of the attribute will be used.

late_cutoff

(Character) Late time cutoff (input as "hh:mm:ss" or "hh:mm"). If provided, "Late_Time" will be included in the output columns.

period_to

(Character) Indicate the units of "Before_Class", "During_Class", "After_Class" and "Total_Time" in the output. Must be one of:

  • "period" (default): return as lubridate::period object

  • "second": return as seconds (numeric)

  • "minute": return as minute (numeric)

  • "hour": return as hour (numeric)

round_digits

(Integer) significant digits to round the numeric columns. If NULL (default), no round.

Value

A data frame (tibble) with class zoom_class. It has the following columns:

  • "Name (Original Name)": the same column "Name (Original Name)" as input file

  • "Name": Current name displayed in Zoom meeting of the participants.

  • "Name_Original": Original name of the participants. It was extracted from the contents within the last balanced parentheses of "Name (Original Name)".

  • "Email": from original "User Email" column

  • "Session_Count": Show counts of how many session that each students joined or leaved Zoom class.

  • "Class_Start" (POSIXct): Compute from date of "Join_Time" with time specified by class_start argument.

  • "Class_End" (POSIXct): Compute from date of "Leave_Time" with time specified by class_end argument.

  • "First_Join_Time": First join time of each students

  • "Last_Leave_Time": Last leave time of each students

  • "Before_Class": Time spent before class_start of each student.

  • "During_Class": Time spent during class (between class_start and class_end) of each student.

  • "After_Class": Time spent after class_end of each student.

  • "Total_Time": "Before_Class" + "During_Class" + "After_Class"

  • "Duration_Minutes": Sum of "Duration (Minutes)" for each students. Notice: Total_Time is likely to be less than original Duration_Minutes because the latter round the decimal down. This difference will be more pronounced when summed with multiple sessions.

  • "Multi_Device": TRUE if students joined Zoom with multiple devices in any session.

  • "Late_Time" (Optional): If provide late_cutoff as "hh:mm:ss", "Late_Time" period is computed by Join_Time - late_cutoff.

Details

By providing time of class started (class_start) and ended (class_end), this function will compute time spent before, during, and after class of each students. Furthermore, Late time period can be calculated from students who joined Zoom class later than certain cutoff time (late_cutoff). If each students joined the classroom using multiple device in any sessions, TRUE will be placed in the "Multi_Device" column of the output.

The result will be displayed one row per student. "Session_Count" will counts how many times each students join or leave the Zoom class.

See also

Checkout class_studentsID() for summary by extracted student's ID, and class_session() for summary of each session.