Design-Based Methods for Ranking Questions
Overview
Provides a design-based toolkit for survey ranking questions. Estimates average ranks, marginal rank probabilities, pairwise comparisons, and ranking distributions, with optional bias correction for random responding via anchor-ranking items or user-supplied random-response rates. Includes Plackett-Luce simulation, visualization, format conversion, and diagnostic checks. Methods are described in Atsusaka and Kim (2025) doi:10.1017/pan.2024.33.
- First CRAN submission. The package was previously available on GitHub under version 0.1.0.
- The bundled
identityandidentity_wdatasets now use item names for the marginal-rank columns:party,religion,gender,race(previouslyapp_identity_1--app_identity_4) andhousehold,neighborhood,city,state(previouslyanc_identity_1--anc_identity_4). Examples and vignettes now pass these columns explicitly, e.g.main_q = c("party", "religion", "gender", "race"). - New exported function
rank_wider()for converting long-format ranking data to wide format (one column per item or a single pasted ranking string).
Show all changes in 0.2.0Hide the rest of the changes in 0.2.0
imprr_direct():anc_correctis now optional. Users can instead supplyp_randomdirectly, or rely on anchor-based estimation of the non-random response rate.- New exported convenience wrapper
add_ipw_weights()for returning the original data augmented with respondent-level IPW weights, with an option to also keep ranking summaries. imprr_direct_rcpp(): correctly delegates toimprr_direct()whenmethod = "fixed", forwarding all population and assumption inputs.rpluce(): when all remaining Plackett-Luce weights become zero after earlier draws, the remaining items are now sampled uniformly at random rather than being ordered by input position.rank_longer(): stricter validation on thereferenceargument and clearer handling of single- vs multi-column input.- Stronger input validation across the package: weights must be finite, non-negative, and sum to a positive number;
Jmust be finite; permutation labels are parsed consistently across compact, delimited, and fixed-width formats (including J > 9). - Permutation-label infrastructure rewritten to support rankings of arbitrary size.
- Documentation: switched to
\href{}{}for external URLs; expanded examples and\value{}sections.
From NEWS.md in the release
Install
Health
- OK13 OKNow
- OK7 OK2026-08-22
Documentation
- Help pages
- 25 (1 internal)includes a package overview page
- Examples that run
- 100%19 run in a plain check
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 0%
- 1. Overview HTML
- 2. Data HTML
- 3. Methods HTML
- 4. Analysis HTML
- 5. Visualization HTML
- 6. Test HTML
Downloads
Repository
- PRs merged (all time)
- 50%
- Median days to close, 50 most recently updated closed issues
- 165
- Median days to close, 50 most recently updated closed PRs
- 82
Issues over time
Commits over time
8 development-tooling and community-health practices detected across 5 families in the upstream repository
Checks run against github.com/sysilviakim/rankingq on 2026-10-25.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-08-26 · The repository has a site deploy workflow
pkgdown site last built 2026-08-26
Show all practicesHide 1 practice
This repository shows signs of AI coding tools.
- GitHub Copilotfirst seen 2025-11-06Pull request: opened by its own account
- Claude Codefirst seen 2026-01-21Named in .Rbuildignore: .claudeNamed in .gitignore: .claudeCommits: at least 2 crediting it in the message
- Claude Opus 4.52 commits · Jan 2026
Dependencies
Code & Tests
Datasets
People & History
- 0.2.0Latest2026-08-21 · current release
- RR 4.6.0 released · 2026-04-24
Package metadata
- First published
- 2026-08-21
- Total releases
- 1 / 1 yrs
- License
- GPL (>= 3) OSI
- Minimum R
- ≥ 4.1.0
- Bundled data
- 37 KB / 2 files
- Download size
- 1.1 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("rankingQ")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-26, which the citation names so these numbers can be found later. More on citing and the projects behind them.