Skip to contents

Select questions from an index

Source: R/select.R
select_questions.Rd

Select explicit IDs in a specified order, filter a bank, or take a reproducible topic-stratified sample without replacement.

Usage

select_questions(
  index,
  ids = NULL,
  n = NULL,
  seed = NULL,
  topics = NULL,
  difficulties = NULL,
  shuffle = FALSE
)

quiz_select_questions(
  index,
  ids = NULL,
  n = NULL,
  seed = NULL,
  topics = NULL,
  difficulties = NULL,
  shuffle = FALSE
)

Arguments

index

A data frame returned by read_question_index().

ids

Optional character vector of question IDs. When supplied with shuffle = FALSE, their order determines the output order.

n

Optional positive integer sample size. Sampling is balanced across the eligible topics as evenly as their available questions allow.

seed

Optional random seed used for sampling or shuffling filtered questions.

topics, difficulties

Optional values used to filter the sampling pool.

shuffle

Whether to shuffle the selected question order. When FALSE, explicit IDs retain their supplied order, supplied topics retain their supplied order, and otherwise index order is retained.

Value

A data frame containing the selected rows.

Examples

index <- read_question_index(example_question_index())
select_questions(index, ids = c("example-numeric", "example-choice"))
#>                id                          file                title      topic
#> 1 example-numeric questions/example-numeric.qmd    Calculate a total Arithmetic
#> 2  example-choice  questions/example-choice.qmd Choose an R function   R basics
#>   difficulty marks         type
#> 1       easy     1    numerical
#> 2       easy     1 singlechoice
select_questions(index, n = 1, seed = 2026, difficulties = "easy")
#>                id                          file             title      topic
#> 1 example-numeric questions/example-numeric.qmd Calculate a total Arithmetic
#>   difficulty marks      type
#> 1       easy     1 numerical