genResponses {conquestr}R Documentation

genResponses

Description

Generates responses to i items for n cases given some item parameters, (true) person abilities, and other inputs.

Usage

genResponses(
  abilities,
  itemParams,
  BMatrix = 1,
  discrim = 1,
  mcarP = 0,
  perturbP = NULL
)

Arguments

abilities

A matrix of person abilities. One column per dimension. Rows are cases.

itemParams

A list of item params of the structure used in 'simplef' (a matrix of k categories by three (category score, delta dot, tau)). See conquestr::makeItemList for a helper to generate this list.

BMatrix

A simplified B-matrix mapping dimensions (columns) to items (rows). Or the integer "1" if items are dichotomous and ability is uni-dimensional.

discrim

A vector of item discrimination paramters, or an integer where all items have constant discrimination.

mcarP

A double indicating the proportion of missing data under the MCAR assumption.

perturbP

A list, where each element of the list contains a data frame referring to an item. Each data frame is either a 1 * 4 data frame describing the general perturbation to apply to the probabilities for that item (currently developed) or a pair of vectors mapping theta to probabilities (not developed). In the first case - the data frame is in this order: - "item": item number (int), - "type": the type of perturbation to apply (string, "flat", or "steep"), - "pivot": probability pivot point around which the perturbation is applied (double in0 < x < 1), - "factor": magnitude of the perturbation (double - when in 0 < x < 100 probs remain positively correlated with theta (0 = no perturbation, 100 = maximum perturbation) when in100 < x < Inf probs are negatively correlated with theta).

Value

A matrix.

Examples

## Not run: 
myResponses<- genResponses(rnorm(1000, 0, 1), runif(10, -2, 3)) # TODO - update this

## End(Not run)

[Package conquestr version 0.9.96 Index]