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

Value

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