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

---

Documentation for package ‘autoFC’ version 1.0.0.1000

• DESCRIPTION file
• User guides, package vignettes and other documentation
• Package README

Help Pages

build_blueprint_blocks	Build Forced-Choice Blocks from a Custom Blueprint
build_target_dist	Create Target Pair Distribution for Scale-Level Fit
cal_block_energy	Fast Calculation of Item Block "Energy"
cal_block_energy_with_iia	Fast Calculation of Item Block "Energy" with Inter-Item Agreement
convert_mole_to_pairwise	Convert Most/Least (MOLE) Survey Data into Pairwise Binary Outcomes
convert_ranks_to_pairwise	Convert Ranked Blocks into Pairwise Binary Outcomes
create_blueprint_template	Generate a Blueprint Template for Forced-Choice Scales
empirical_reliability	Empirical Reliability Estimates
extract_adjacent_pairs_stan	Extract Only Adjacent Rank Pairs for Stan (Heister et al., 2025)
extract_tirt_stan_scores	Extract Trait Scores and SEs from a Fitted Stan TIRT Model
facfun	Function for Checking If All Items in a Vector Are Unique
FC_blocks	Actual FC Blocks construted from HEXACO-60 Items from Four Respondent Groups
FC_item_info	Keying and factor information for HEXACO-60 items
generate_tirt_lavaan_syntax	Generate lavaan Syntax for Thurstonian Models
generate_tirt_mplus_syntax	Generate Mplus Syntax for Thurstonian IRT (TIRT) or Thurstonian Factor Model (TFM)
generate_tirt_stan_syntax	Generate Stan Syntax and Data for TIRT Models
get_CFA_estimates	Conduct Confirmatory Factor Analysis (CFA) and Obtain Parameter Estimates
get_iia	Helper Function for Outputting IIA Characteristics of Each Block
get_simulation_matrices	Generate Simulated Person and Item Parameter Matrices for the TIRT Model
HEXACO_example_data	Example HEXACO Response Data
make_random_block	Construction of Random Item Blocks
MOLE_data	Actual Response to FC scales in MOLE format
optimize_blocks	Automatic Item Pairing Method in Forced-Choice Test Construction
plot_scores	Scatter Plot for True vs Estimated Scores, True Score vs Absolute Error, etc.
predict_tirt_stan	Predict Trait Scores for New Data using a Fitted Stan Model
prepare_tirt_stan_data	Prepare pairwise list data for Stan
RMSE_range	Calculate Overall or Binned RMSE of Trait Scores
score_tirt_ipsative	Calculate Classical Ipsative (Sum) Scores for Forced-Choice Measures
score_tirt_lavaan	Fast, Analytical Trait Scoring for Second-Order TIRT using optim()
score_tirt_mplus	Fast Analytical Trait Scoring for Mplus TIRT/TFM Models
score_tirt_stan	Run Stan TIRT Model and Extract Formatted Scores
summarize_trait_pairs	Summarize Trait and Keying Pairs in a Constructed Forced-Choice Test