cdss_wf_read_skill_assignment: Read an assignment of taught and required skills for a set of...

View source: R/cdss_wf_read_skill_assignment.R

cdss_wf_read_skill_assignmentR Documentation

Read an assignment of taught and required skills for a set of learning objects from file and do the whole workflow up to a surmise function on skills

Description

cdss_wf_read_skill_assignment expects an ODS or XLSX file with two sheets assigning taught and required, respectively, skills to learning objects with two columns each. Alternatively, two CSV files can be specified. In the sheets/CSV files, the first column contains the IDs of learning objects and the second row the IDs of single skills required or taught, respectively, by this learning object. It returns a list of two binary matrices, "taught" and "required". Each matrix has one row per learning object and one column per skill. The cells contain a "1" if the skill is taught or required, respectively, by the learning object and a "0" otherwise,

Usage

cdss_wf_read_skill_assignment(
  filename,
  filename2 = NULL,
  filetype = "auto",
  taughtname = "Taught",
  requiredname = "Required",
  header = TRUE,
  sep = ",",
  dec = ".",
  warnonly = FALSE,
  verbose = TRUE
)

Arguments

filename

Name of the file (in case of CSV files the one with TAUGHT assignments)

filename2

Name of the CSV file with REQUIRED assignments (if applicable)

filetype

Type of the file, allowed values are "auto", "ODS", "XLSX", and "CSV"

taughtname

Name of the sheet with required assignment (default = "Taught")

requiredname

Name of the sheet with required assignment (default = "Required")

header

Boolean specifying whether the CSV-files contain a header line (default = TRUE)

sep

Column separator for CSV files (default ",")

dec

Decimal point character for CSV files (default ".")

warnonly

Are non-compliant SAs allowed? (default = FALSE)

verbose

Verbosity of compliance test (default = TRUE)

Value

List of four elements: sfs (surmise function between skills), sfl (surmise function between learning objects) srs (surmise relation between skills, if available; NULL otherwise) srl (surmise relation between learning objectrs, if available; NULL otherwise)

See Also

Other functions reading skill assignments: cdss_read_skill_assignment_csv(), cdss_read_skill_assignment_ods(), cdss_read_skill_assignment_xlsx()


CDSS documentation built on April 12, 2025, 1:44 a.m.