ForceChoice

1.0.0

Forced-Choice Modeling Based on Item Response Theory and Cognitive Diagnostic Models

0packages depend

23downloads / year

0.6%test coverage

9/11checks pass

Overview

About

Maintained by Haijiang QinFirst published 2026-07-301 releasesCRAN page ↗

Fits, simulates, and evaluates forced-choice and traditional item response theory (IRT) models for noncognitive assessment. Eight model families are supported, spanning dominance (multidimensional IRT (MIRT) 1PL--4PL; multidimensional generalized partial credit model (MGPCM)), ideal-point unfolding (multidimensional generalized graded unfolding model (MGGUM)), and forced-choice designs (forced-choice multidimensional IRT (FCMIRT), forced-choice generalized graded unfolding model (FCGGUM), Thurstonian IRT (TIRT), forced-choice diagnostic classification model (FCDCM), forced-choice generalized deterministic inputs, noisy "and" gate model (FCGDINA)) that mitigate response biases such as acquiescence and social desirability. Core estimation backends include full Bayesian inference via Hamiltonian Monte Carlo (Stan) and a fast improved stochastic expectation-maximization (iStEM) algorithm suitable for large-scale data; FCGDINA also provides a deterministic expectation-maximization (EM) estimator. Comprehensive model evaluation uses the limited-information M2 family of goodness-of-fit statistics (Maydeu-Olivares and Joe, 2005 doi:10.1198/016214504000002069; 2006 doi:10.1007/s11336-005-1295-9) together with root mean square error of approximation (RMSEA), comparative fit index (CFI), Tucker-Lewis index (TLI), and standardized root mean square residual (SRMSR).

Install

R (CRAN)Ubuntu (r2u)Fedora (COPR)

install.packages("ForceChoice", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-forcechoice

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-ForceChoice

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

Health

CRAN checks

1ERROR1NOTE9OK

Failing flavors

NOTE r-devel-linux-x86_64-debian-gcc
ERROR r-devel-windows-x86_64

Slowest check: 31.9 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 0.03

0.6%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

ERROR2026-07-31
6 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE

Documentation

READMEYes · 819 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 67% structuredCode of conductNoContributing guideNo

Examples that run: 97%
Documented parameters: 100%
Return-value docs: 100%
References docs: 13%

Downloads

CRAN downloads in the past year

Rank #24,667 · ~0/day · ~2/mo

Releases R versions

Daily download trend is not available in this view yet.

2330 days

2390 days

231 year

Compare downloads with other packages →

Also on7 r2u

Dependencies

Declared dependencies

17 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.1.0

Imports (10)

coda GPArotationMASSmethodsnumDerivparallelRcpp (>= 0.12.0)RcppParallel rstan rstantools

LinkingTo (7)

BH Rcpp RcppArmadillo RcppEigen RcppParallel rstan StanHeaders

Suggests (3)

knitr loo rmarkdown

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

Datasets

People & History

People (2)

Maintainer (1)

Haijiang Qin

Author, Maintainer, Copyright holder

Authors (2)

Haijiang Qin

Author, Maintainer, Copyright holder

Lei Guo

Author, Copyright holder

Haijiang Qin

Author, Maintainer, Copyright holder

Lei Guo

Author, Copyright holder

Package Timeline

1 release. R releases are shown for context.

1.0.0Latest
2026-07-30 · current release
R
R 4.6.0 released · 2026-04-24

Package metadata

First published: 2026-07-30
Total releases: 1 / 1 yrs
License: GPL (>= 3) OSI
Minimum R: ≥ 4.1.0
Bundled data: 0.6 KB / 1 file
Download size: not tracked yet
Installed size: not tracked yet
With dependencies: not tracked yet

Report a problem with this page →