This release corrects statistical errors found in a review of the package. Some results change. Check the items under CHANGES IN RESULTS before comparing with analyses run on earlier versions.

CHANGES IN RESULTS

  • kendallTau() on matrices tests the average tau with each row (participant) as an independent ranking, and weights rows by their number of pairs. Earlier versions pooled all pairs into one ranking of N_effective items, which understated precision. With 2,000 random triads the z-values had a standard deviation of about 0.2 instead of 1, so real associations were often reported as not significant. Expect larger z-values and smaller p-values in trials with many participants. Average tau is unchanged for complete triads. N_effective is still reported, for reference only.

  • kendallTau() gains alternative = c("two.sided", "greater", "less"). The default is now two-sided. Earlier versions reported a one-sided p-value for a positive association. The column name Pr(>|z|) is unchanged. null.rm is now passed from the matrix method to each row.

  • crossvalidation() reports Kendall’s tau for Plackett-Luce trees on the held-out test set. Earlier versions compared predictions with the training rankings, an in-sample measure. Values will be lower and honest.

  • preference_index() counts each item once per set. Earlier versions inflated n by the number of other items in each set and gave larger sets more weight in the averages. Sets with a single ranked item are skipped. The bottom probability is computed exactly by recursion over subsets.

  • regret() assigns each regret to the right item when nodes are not in sorted order (for example terminal node 10 before node 3). This affected trees with node ids of 10 or more, including worthSE and regretSE.

  • regret() weights nodes by their share of observations for pltree objects, and models by their number of rankings for lists of PlackettLuce models, so a small node no longer counts as much as a large one. Worst regret, a worst case, is not weighted. The new node.weights argument sets weights; equal weights reproduce the previous results.

  • anova() for Plackett-Luce models no longer rounds the log-likelihood difference before computing the statistic, and computes the p-value with lower.tail = FALSE.

  • likelihood_ratio() computes the p-value with lower.tail = FALSE.

  • kendallTau_bootstrap() resamples participants with replacement and returns the pair-weighted average tau of each resample. Earlier versions computed tau on only four subsets of the data and bootstrapped those four values, which gave a poor estimate of the variability of tau. The function also reset the random number stream; with seed it now leaves the caller’s stream unchanged, and without seed it uses the current stream. Arguments and output format are unchanged.

BUG FIXES

  • crossvalidation() keeps folds aligned with the data when rows are dropped for missing values, accepts folds given as a list of training rows, stops with an error when a model or a score cannot be computed (instead of returning zeros), and no longer changes the caller’s random number stream when seed is given. The package of the model (for example ‘PlackettLuce’ or ‘gnm’) must be attached, and the function says so when it is not.
  • likelihood_ratio() checks the split vector, accepts grouped rankings as in its documented example and passes ... to PlackettLuce().
  • rank_tricot2() reads factor ranks by their values and gains strict = FALSE, an opt-in check for missing, duplicated, tied and non-consecutive ranks.
  • rank_tricot() warns when the same item appears twice in a row.

TESTS AND DOCUMENTATION

  • Corrected typos and unclear wording in the help pages (for example btpermute() named a non-existent argument n.iteractions, and the arguments of the default method of kendallW() were described as pltree objects).

  • Unit tests in tests/testthat cover these functions and run under R CMD check, including a simulation of the null distribution of kendallTau().

  • Added an R CMD check workflow for Linux, macOS and Windows, and AGENTS.md, a guide for AI agents working on the package.

NEW FEATURES

  • Added preference_index() to compute a model-based preference index
    from Plackett–Luce worth parameters.
    The function reports, for each item:
    • expected top probability (%),
    • expected bottom probability (%),
    • net winning probability (%), and
    • normalized worth.
  • Added rank_tricot2() — a redesigned ranking parser for tricot data.
    The function:
    • handles ties and missing values more robustly,
    • enforces stricter validation of A–B–C syntax,
    • provides clearer error messages, and
    • returns rankings in a format consistent with Plackett–Luce models.

IMPROVEMENTS

  • Updated internal utilities in rank_numeric() to interface with rank_tricot2() for improved performance and error handling.
  • Minor internal cleanup (no user-visible behavioural changes).

BUG FIXES

  • None reported for this release.

IMPROVEMENTS

IMPROVEMENTS

  • Implements the function resample() to re-sample Plackett-Luce coefficients
  • Adds standard errors in regret()
  • Adds pairwise_probs() to compare worth parameters following the Luce’s Axiom

BUG FIXES

  • Fix the computation of maximized regret in regret(). Using sum(x^2) instead of sum(x)^2

IMPROVEMENTS

  • Implement anova() method for PlackettLuce models
  • Implement likelihood-ratio test for PlackettLuce models. Function likelihood_ratio()

IMPROVEMENTS

Changes in behaviour

IMPROVEMENTS

  • Adds argument validate.rankings to rank_tricot() to help in identifying possible issues in input tricot ranking like NA, ties or letters different than A, B or C
  • Adds argument average to kendallTau() to allow returning the kendall correlation for each entry in a matrix and PlackettLuce ranking
  • Adds argument na.omit to kendallTau() to remove entries with NA
  • Code is written using = instead of <- to avoid typing stress

BUG FIXES

  • Fixes an issue in plot.pltree() when multi-comparison is required but multicompView is not loaded.

IMPROVEMENTS

  • Fix issues in CRAN cmd checks

IMPROVEMENTS

First version on CRAN

IMPROVEMENTS

  • add argument qve to skip quasi-variance to plot coefficients in plot_tree()
  • rank_numeric() deals with ids of class characters
  • argument ref can be used in multicompPL() to select the reference item
  • adjust scale in the plot() method for summarise_agreement() using the argument scales, where scales = 100 is to set the scale from 0-100 and scales = 1 for a scale from 0-1
  • plot method for multcompPL()

BUG FIXES

  • Fix an issue in rank_binomial() in assigning the ids when argument disaggregate = TRUE
  • Fix an issue in setting up the permuted formulas in btpermute(), with the fix n.formula = n.vars + 1

NEW FEATURES

  • forward selection is added with forward()
  • btpermute() is added for model selection with BTm()
  • abbreviation method in plot methods of summarise_* functions

IMPROVEMENTS

  • No user visible improvements

CHANGES IN BEHAVIOUR

IMPROVEMENTS

  • Write documentation in good practice. Avoid calling the entire package but specific functions.

CHANGES IN BEHAVIOUR

  • argument “ascending” in rank_numeric() in restricted to floating point numbers. Integer values are ranked as provided by input.

NEW FEATURES

CHANGES IN BEHAVIOUR

  • Rename functions agreement(), dominance(), favourite(), and victories() with the tag summarise and add it into summarise functions. No warking message provided. New functions are summarise_agreement(), summarise_dominance(), summarise_favourite(), and summarise_victories()

  • Argument ‘index’ is removed from rainfall() and temperature(), all indices are given by default

NEW FEATURES

  • .get_timeseries() now implements the Euclidean method to search for its nearest neighbour in the nasapower output. This optmises the function and reduce dependencies
  • ranking functions now implements internal processess to decode ranks and reduce dependencies
  • pseudoR2() as a S3 method for objects of class “glm”, “gnm”, “bttree” and “pltree”
  • kendallTau() as S3 method for objects of class “numeric”, “matrix”, “data.frame”, “rankings”, “grouped_rankings”

NEW FEATURES

  • Function to summarise results from pairwise comparisons, agreement(), dominance(), favourite() and victories()
  • Increased test coverage
  • Successfull migration from ClimMobTools to gosset

NEW FEATURES

  • Migrating functions from ClimMobTools to gosset

CHANGES IN BEHAVIOUR

NEW FEATURES

  • predict() method for crossvalidation objects
  • pseudoR2() for object of class “pltree” extracts null loglik from PlackettLuce
  • replace to_rankings() by rank_PL(). Warning message added
  • replace num2rank() by rank_decimal(). No warning message added
  • replace to_paircomp() by rank_paircomp(). No warning message added
  • GitHub-only release of prototype package.