tbl_arrange_RAT_questions: Arrange RAT questions

Description Usage Arguments Value

View source: R/readiness_assessment_tests.R


Function to make it easy to arrange an RAT either by fixed numbers (fixed_number_column) or semi-randomly or completely randomly. Can also arrange questions within specific groups using the group_by_column, and can use specific starting numbers for iRAT and tRAT numbering (which need not be the same in case tRATs need to match a specific IF-AT number sequence and iRATs should match a scantron). In case iRAT numbers are different from tRAT numbers, the tRAT numbering is the one matched to the answer key since this needs to match the IF-AT scratch-off.


tbl_arrange_RAT_questions(rat, by = "original", tRAT_n_start = 1,
  iRAT_n_start = tRAT_n_start, iRAT_sel_per_q = 1,
  fixed_number_column = NULL, group_by_column = NULL,
  random_seed = random())



Readiness Assessment Test object


what to arrange by, options: by="original" leaves the original order as encountered, by="random" generates a random order, by="semi-random" generates a random order except for questions that have the fixed_number_column set, and by="fixed" uses the fixed_number_column (which has to be set for all questions in the latter case!).


the start number for the tRAT question numbering (if the rRAT should fit a different part of an IF-AT), only matters if by is NOT "fixed". Default is 1.


the start number for the iRAT question numbering. By default the same as tRAT_n_start. Specify a different value from tRAT_n_start e.g. if tRAT starts at a higher IF-AT number but iRAT numbers should start at 1.


number of selections per question for the iRAT portion of this test, e.g. when using scantrons and giving the students the option to hedge their bets on the iRAT portion of the test.


name of a column in the RAT questions data frame that indicates the fixed question number. Only relevant if by="semi-random" or by="fixed"


name of a column in the RAT questions data frame that indicates which questions to group together (groups will be arranged alphabetically, those with undefined group come last). Only relevant if by="random" or by="semi-random". Throws an error if grouping and any fixed number questions are incompatible (e.g. a question has fixed number 5 but is part of the first group of only 3 questions).


can overwrite with a fixed value (e.g. random_seed=42) to get a reproducible "random" order in by="random" or by="semi-random" mode.


returns the RAT object with the location in the test specified

KopfLab/tbltools documentation built on March 19, 2018, 9:14 a.m.