simulate_fc_data: Simulate Observed Forced-Choice Responses from Latent...

In autoFC: Automatic Toolkit for Construction, Optimization, Scoring and Simulation of Forced-Choice Tests

Simulate Observed Forced-Choice Responses from Latent Utilities

Description

Simulates observed forced-choice responses (either complete rankings, Most/Least partial rankings, or binary pairwise comparisons) from a matrix of continuous latent utilities and a specified block design. This is used in conjunction with get_simulation_matrices(), taking use of the utility values it produces.

Usage

simulate_fc_data(utility_data, blocks, format = c("RANK", "MOLE", "PAIRWISE"))

Arguments

utility_data	A data frame or matrix of simulated latent utilities (e.g., the Utility output from get_simulation_matrices()).
blocks	A matrix of block designs where each row represents a block of item IDs (e.g., output of optimize_blocks()).
format	Character. The desired output format: "RANK" for block-grouped rankings, "MOLE" for relative block position choice, or "PAIRWISE" for binary comparisons.

Value

A data frame of the simulated observed responses. For "RANK", columns represent the assigned rank of each item in the block (e.g., "b1_i1_rank", "b1_i2_rank"). For "MOLE", columns indicate which item slot in the block was selected as most/least (e.g., "b1_most", "b1_least" with values from 1 to block_size). For "PAIRWISE", columns correspond to pair combinations (e.g., "i1i2").

autoFC documentation built on July 14, 2026, 5:07 p.m.