touch_rules function

Add or modify scoring rules

It is occasionally necessary to alter or add a scoring rule, e.g. in case of a key error. This function offers the possibility to do so and also allows you to add new items to your project

touch_rules(db, rules)

Arguments

• db: a connection to a dexter project database
• rules: A data frame with columns item_id, response, and item_score. The order is not important but spelling is. Any other columns will be ignored. See details

Returns

If the scoring rules pass a sanity check, a small summary of changes is printed and nothing is returned. Otherwise this function returns a data frame listing the problems found, with 4 columns:

• item_id: id of the problematic item
• less_than_two_scores: if TRUE, the item has only one distinct score
• duplicated_responses: if TRUE, the item contains two or more identical response categories
• min_score_not_zero: if TRUE, the minimum score of the item was not 0

Details

The rules should contain all rules that you want to change or add. This means that in case of a key error in a single multiple choice question, you typically have to change two rules.

Examples

## Not run:
\donttest{
# given that in your dexter project there is an mc item with id 'itm_01', 
# which currently has key 'A' but you want to change it to 'C'.

new_rules = data.frame(item_id='itm_01', response=c('A','C'), item_score=c(0,1))
touch_rules(db, new_rules)
}
## End(Not run)