test_personsItems: checks the relationship between the person parameter...

In exhaustiveRasch: Item Selection and Exhaustive Search for Rasch Models

checks the relationship between the person parameter distribution and the item (or: threshold) locations for defined criteria

Description

checks the relationship between the person parameter distribution and the item (or: threshold) locations for defined criteria

Usage

test_personsItems(
  items = NULL,
  dset = NULL,
  na.rm = TRUE,
  model = NULL,
  p.par = NULL,
  modelType = NULL,
  gap_prop = 0,
  extremes = TRUE,
  estimation_param = NULL
)

Arguments

items	a numeric vector containing the index numbers of the items in dset that are used to fit the model
dset	a data.frame containing the data
na.rm	a boolean value. If TRUE, all cases with any NA are removed (na.omit). If FALSE, only cases with full NA responses are removed
model	on object of a fit Rasch model, estimated with the packages 'eRm' (classes 'RM', 'PCM' or 'RSM'), 'psychotools' (classes raschmodel, 'pcmodel' or 'rsmodel') or 'pairwise' (class 'pers'), matching the value of modelType. If 'model' is provided, this model is used. If NULL, a model is fit using 'dset' and 'items'.
p.par	a person parameter object matching the class of 'model'. If NULL, the person parameters will be estimated.
modelType	a character value defining the rasch model to fit. Possible values: "RM", "PCM", "RSM".
gap_prop	a numeric value between 0 and 1 that sets the criterion for the minimum proportion of neighboring person parameters with an item/threshold location in between. If set to 0, this criterion will not be checked.
extremes	a boolean value indicating if a check for the item/threshold locations left of the 2nd lowest and right of the 2nd highest person parameter.
estimation_param	options for parameter estimation using estimation_control

Value

if the criteria are met, a list containing 3 elements is returned: the item combination that was tested, a list of the class the model was estimated with (depending on modelType and estimation_param$est) with the fit model and a list with a person parameter object (depending on estimation_param$est). If the criteria are not met, NULL is returned.

exhaustiveRasch documentation built on April 3, 2025, 6:18 p.m.