View source: R/itemCategoryMinMaxConstraint.R
itemCategoryRangeConstraint | R Documentation |
itemCategoriesRange
, itemCategoriesMin
, and itemCategoriesMax
create constraints related to item categories/groupings (as
represented by itemCategories
). That is, the created
constraints assure that the number of items of each category per test form is either
smaller or equal than the specified max
, greater than or equal to min
or both range
.
itemCategoryRangeConstraint(
nForms,
itemCategories,
range,
whichForms = seq_len(nForms),
info_text = NULL,
itemIDs = names(itemCategories)
)
itemCategoryMinConstraint(
nForms,
itemCategories,
min,
whichForms = seq_len(nForms),
info_text = NULL,
itemIDs = names(itemCategories)
)
itemCategoryMaxConstraint(
nForms,
itemCategories,
max,
whichForms = seq_len(nForms),
info_text = NULL,
itemIDs = names(itemCategories)
)
itemCategoryDeviationConstraint(
nForms,
itemCategories,
targetValues,
allowedDeviation,
relative = FALSE,
whichForms = seq_len(nForms),
info_text = NULL,
itemIDs = names(itemCategories)
)
nForms |
Number of forms to be created. |
itemCategories |
a factor representing the categories/grouping of the items |
range |
a matrix with two columns representing the the minimal and the
maximum frequency of the items from each level/category |
whichForms |
An integer vector indicating which test forms should be constrained. Defaults to all the test forms. |
info_text |
a character string of length 1, to be used in the |
itemIDs |
a character vector of item IDs in correct ordering, or NULL. |
min |
the minimal sum of the |
max |
the minimal sum of the |
targetValues |
an integer vector representing the target number per category.
The order of the target values should correspond with the order of the levels
of the factor in |
allowedDeviation |
the maximum allowed deviation from the |
relative |
a logical expressing whether or not the |
itemCategoriesDeviation
also constrains the minimal and the maximal value
of the number of items of each category per test form, but based on chosen
targetValues
, and maximal allowed deviations (i.e., allowedDeviation
)
from those targetValues
.
A sparse matrix.
itemCategoryMinConstraint()
: constrain minimum value
itemCategoryMaxConstraint()
: constrain maximum value
itemCategoryDeviationConstraint()
: constrain the distance form the targetValues
## constraints to make sure that there are at least 2 and maximally 4
## items of each item type in each test form
nItems <- 30
item_type <- factor(sample(1:3, size = nItems, replace = TRUE))
itemCategoryRangeConstraint(2, item_type, range = cbind(min = rep(2, 3), max = rep(4, 3)))
## or alternatively
itemCategoryDeviationConstraint(2, item_type,
targetValues = rep(3, 3),
allowedDeviation = rep(4, 3))
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.