Cite literature justifying the multinomial functions - #146
Open
joethorley wants to merge 3 commits into
Open
Conversation
Add @references to the four multinomial roxygen blocks: the multinomial-Poisson identity underlying the log-likelihood and deviance (Baker 1994; McCullagh and Nelder 1989; Forster 2010; Agresti 2013), the standardized and deviance residual definitions (Haberman 1973; Pierce and Schafer 1986), and the joint per-trial replicate used for posterior predictive residuals (Gelman, Meng and Stern 1996; Johnson, Kotz and Balakrishnan 1997). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Only the sum over a `group` is exact, so document that LOO/WAIC should treat the trial rather than the row as the leave-one-out unit, and cite Vehtari, Gelman and Gabry 2017. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
joethorley
force-pushed
the
multinom-references
branch
from
August 25, 2026 09:30
f1cb37e to
de1c77a
Compare
nehill197
approved these changes
Aug 25, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds
@referencesto the four multinomial roxygen blocks (docs only, nocode changes) and regenerates the Rd files.
log_lik_multinom(): Baker 1994; McCullagh and Nelder 1989; Forster 2010 -the multinomial-as-independent-Poissons identity the row-wise log-likelihood
implements, and its validity under Bayesian inference.
dev_multinom(): McCullagh and Nelder 1989; Baker 1994; Agresti 2013 -deviance as scaled log-likelihood-ratio, and the summed-Poisson-deviance
equals multinomial G-squared result.
res_multinom(): Haberman 1973; Pierce and Schafer 1986; Gelman, Meng andStern 1996 - the
(1 - prob)factor in the standardized residual, thedeviance residual as default
type, and posterior predictive replication.ran_multinom(): Johnson, Kotz and Balakrishnan 1997; Gelman, Meng andStern 1996 - the multinomial covariance structure the joint per-trial draw
preserves.
tools::checkRd()is clean on all four Rd files.Refs #62. Targets
add-multinom(#145).🤖 Generated with Claude Code