knitr::opts_chunk$set( collapse = TRUE, comment = "#>" )
This vignette shows how to use the multpois
package for analyzing nominal response data.
Nominal responses, sometimes called multinomial responses, are unordered categories. In
certain experiments or surveys, the dependent variable can be one of N categories.
For example, let's say we ask people what their favorite ice cream flavor is: vanilla, chocolate, or strawberry. This three-category response would be a polytomous dependent variable. Also, let's say we wish to ask both adults and children about their favorite ice cream flavors to see if there is a difference by age group. We would then have a two-level between-subjects factor, Age. If we ask each respondent only once, this data set would represent a one-way between-subjects design. But perhaps we ask each participant once each season—in fall, winter, spring, and summer—to see if their responses vary by season. Now we would have a four-level within-subjects factor, Season, resulting in repeated measures, since each respondent would be asked four times.
The multpois
package helps us analyze this type of data, where the dependent variable is nominal.
It does so by modeling nominal responses as counts of category choices and uses mixed-effects Poisson
regression to analyze these counts (Baker 1994, Chen & Kuo 2001). This technique is known as
the multinomial-Poisson transformation (Guimaraes 2004) or trick (Lee et al. 2017).
R already provides options for the following situations:
If the response is dichotomous, and the factors are only between-subjects,
we can build a model using glm
with family=binomial
from the base stats
package.
The Anova
function from the car
package can be used to produce main effects and
interactions. The emmeans
function from the emmeans
package can be used to produce
post hoc pairwise comparisons.
If the response is polytomous, and the factors are only between-subjects,
we can build a model using multinom
from the nnet
package. The Anova
function from
the car
package can be used to produce main effects and interactions. However, we
cannot use the emmeans
function from the emmeans
package in the usual fashion. An
approach to this issue by emmeans
package author Russ Lenth is offered below.
If the response is dichotomous, and one or more factors is within-subjects, we can build
a model using glmer
with family=binomial
from the lme4
package. The Anova
function
from the car
package can be used to produce main effects and interactions. The emmeans
function from the emmeans
package can be used to produce post hoc pairwise comparisons.
If the response is polytomous, and one or more factors is within-subjects, there is no easy
option similar to the three above. The multinom
function in nnet
cannot accept random factors
to handle repeated measures, and the glmer
function in lme4
does not offer a
family=multinomial
option. This package was created to address this case in particular, although
it can address the above three cases, also.
The first four analyses below illustrate 2×2 designs having between- and within-subjects factors and dichotomous and polytomous responses. (The functions in multpois
are not limited to 2×2 designs;
any number of between- and within-subjects factors can be used.) The first three examples first use
existing R solutions to which the results from multpois
functions can be compared.
The fifth example returns to our ice cream scenario, above, and analyzes a mixed factorial design with one
between-subjects factor (Age
) and one within-subjects factor (Season
).
bs2
data set.bs3
data set.ws2
data set.ws3
data set.icecream
data set.Baker, S.G. (1994). The multinomial-Poisson transformation. The Statistician 43 (4), pp. 495-504. https://doi.org/10.2307/2348134
Chen, Z. and Kuo, L. (2001). A note on the estimation of the multinomial logit model with random effects. The American Statistician 55 (2), pp. 89-95. https://www.jstor.org/stable/2685993
Guimaraes, P. (2004). Understanding the multinomial-Poisson transformation. The Stata Journal 4 (3), pp. 265-273. https://www.stata-journal.com/article.html?article=st0069
Lee, J.Y.L., Green, P.J.,and Ryan, L.M. (2017). On the “Poisson trick” and its extensions for fitting multinomial regression models. arXiv preprint available at https://doi.org/10.48550/arXiv.1707.08538
These are the libraries needed for running the code in this vignette:
library(car) library(nnet) library(lme4) library(lmerTest) library(emmeans)
Let's also load our library:
library(multpois)
Let's load and prepare our first data set, a 2×2 between-subjects design with
a dichotomous response. Factor X1
has levels {a, b}
, factor X2
has levels
{c, d}
, and response Y
has categories {yes, no}
.
data(bs2, package="multpois") bs2$PId = factor(bs2$PId) bs2$Y = factor(bs2$Y, levels=c("yes","no")) bs2$X1 = factor(bs2$X1) bs2$X2 = factor(bs2$X2) contrasts(bs2$X1) <- "contr.sum" contrasts(bs2$X2) <- "contr.sum"
Let's visualize this data set using a mosaic plot:
``r
, {a, d}
, {b, c}
, and {b, d}
.", fig.height=4.5, fig.width=4}
xt = xtabs( ~ X1 + X2 + Y, data=bs2)
mosaicplot(xt, main="Y by X1, X2", las=1, col=c("lightgreen","pink"))
Given `X1` and `X2` are both between-subjects factors, and `Y` is a dichotomous response, we can analyze this data set using conventional logistic regression: ```r m1 = glm(Y ~ X1*X2, data=bs2, family=binomial) Anova(m1, type=3) emmeans(m1, pairwise ~ X1*X2, adjust="holm")$contrasts
We can also analyze this data set using the multinomial-Poisson trick, which converts nominal responses to category counts and analyzes these counts using Poisson regression:
m2 = glm.mp(Y ~ X1*X2, data=bs2) Anova.mp(m2, type=3) glm.mp.con(m2, pairwise ~ X1*X2, adjust="holm")
The omnibus results from logistic regression and from the multinomial-Poisson trick match, and the results from the post hoc pairwise comparisons are similar.
Let's load and prepare our second data set, a 2×2 between-subjects design with
a polytomous response. Factor X1
has levels {a, b}
, factor X2
has levels
{c, d}
, and response Y
has categories {yes, no, maybe}
.
data(bs3, package="multpois") bs3$PId = factor(bs3$PId) bs3$Y = factor(bs3$Y, levels=c("yes","no","maybe")) bs3$X1 = factor(bs3$X1) bs3$X2 = factor(bs3$X2) contrasts(bs3$X1) <- "contr.sum" contrasts(bs3$X2) <- "contr.sum"
Let's again visualize the data using a mosaic plot:
``r
, {a, d}
, {b, c}
, and {b, d}
.", fig.height=4.5, fig.width=4}
xt = xtabs( ~ X1 + X2 + Y, data=bs3)
mosaicplot(xt, main="Y by X1, X2", las=1, col=c("lightgreen","pink","lightyellow"))
Given `X1` and `X2` are both between-subjects factors, and `Y` is a polytomous response, we might wish that `glm` had a `family=multinomial` option analogous to its `family=binomial` option, but it does not. Fortunately, we can analyze polytomous response data for (only) between-subjects factors using the `multinom` function from the `nnet` package: ```r m3 = multinom(Y ~ X1*X2, data=bs3, trace=FALSE) Anova(m3, type=3)
Unfortunately, emmeans
does not work straightforwardly with multinom
models. A solution to this issue
from Russ Lenth, lead author of emmeans
, was posted on StackExchange:
e0 = emmeans(m3, ~ X1*X2 | Y, mode="latent") c0 = contrast(e0, method="pairwise", ref=1) test(c0, joint=TRUE, by="contrast")
We can also analyze this data set using the multinomial-Poisson trick:
m4 = glm.mp(Y ~ X1*X2, data=bs3) Anova.mp(m4, type=3) glm.mp.con(m4, pairwise ~ X1*X2, adjust="holm")
Again, the results from multinomial logistic regression and from the multinomial-Poisson trick match. The results from the post hoc pairwise comparisons are similar.
Let's load and prepare our third data set, a 2×2 within-subjects design with
a dichotomous response. Factor X1
has levels {a, b}
, factor X2
has levels
{c, d}
, and response Y
has categories {yes, no}
. Now the PId
factor is repeated
across rows, indicating participants were measured repeatedly.
data(ws2, package="multpois") ws2$PId = factor(ws2$PId) ws2$Y = factor(ws2$Y, levels=c("yes","no")) ws2$X1 = factor(ws2$X1) ws2$X2 = factor(ws2$X2) contrasts(ws2$X1) <- "contr.sum" contrasts(ws2$X2) <- "contr.sum"
Let's visualize this data set using a mosaic plot:
``r
, {a, d}
, {b, c}
, and {b, d}
.", fig.height=4.5, fig.width=4}
xt = xtabs( ~ X1 + X2 + Y, data=ws2)
mosaicplot(xt, main="Y by X1, X2", las=1, col=c("lightgreen","pink"))
Given `X1` and `X2` are both within-subjects factors, and `Y` is a dichotomous response, we can analyze this using mixed-effects logistic regression. The function `glmer` from the `lme4` package provides this to us: ```r m5 = glmer(Y ~ X1*X2 + (1|PId), data=ws2, family=binomial) Anova(m5, type=3) emmeans(m5, pairwise ~ X1*X2, adjust="holm")$contrasts
We can also analyze this data set using the multinomial-Poisson trick, now with an underlying mixed-effects Poisson regression model:
m6 = glmer.mp(Y ~ X1*X2 + (1|PId), data=ws2) Anova.mp(m6, type=3) glmer.mp.con(m6, pairwise ~ X1*X2, adjust="holm")
The results from mixed-effects logistic regression and results from the multinomial-Poisson trick match, including the results from the post hoc pairwise comparisons.
This fourth example illustrates the main reason that the multpois
package was created. Unlike the three
examples above, there are no straightforward options for analyzing nominal responses with repeated
measures and obtaining ANOVA-style results. Some functions do offer mixed-effects multinomial regression modeling, such as mblogit
in the mclogit
package, but they do not enable ANOVA-style output. Other advanced methods exist, such as Markov Chain Monte Carlo (MCMC) methods in the MCMCglmm
package, which does have a
family=multinomial
option, but these Bayesian methods are complex and deviate from the approaches illustrated
above. Fortunately, we can again use the multinomial-Poisson trick.
Let's load and prepare our fourth data set, a 2×2 within-subjects design with
a polytomous response. Factor X1
has levels {a, b}
, factor X2
has levels
{c, d}
, and response Y
has categories {yes, no, maybe}
. Again, the PId
factor is repeated
across rows, indicating participants were measured repeatedly.
data(ws3, package="multpois") ws3$PId = factor(ws3$PId) ws3$Y = factor(ws3$Y, levels=c("yes","no","maybe")) ws3$X1 = factor(ws3$X1) ws3$X2 = factor(ws3$X2) contrasts(ws3$X1) <- "contr.sum" contrasts(ws3$X2) <- "contr.sum"
Let's visualize this data set using a mosaic plot:
``r
, {a, d}
, {b, c}
, and {b, d}
.", fig.height=4.5, fig.width=4}
xt = xtabs( ~ X1 + X2 + Y, data=ws3)
mosaicplot(xt, main="Y by X1, X2", las=1, col=c("lightgreen","pink","lightyellow"))
Because `multinom` from the `nnet` package cannot accept random factors, it cannot model repeated measures. And because `glmer` from the `lme4` package has no `family=multinomial` option, it cannot model polytomous responses. Fortunately, with the multinomial-Poisson trick, we can analyze polytomous responses from repeated measures: ```r m7 = glmer.mp(Y ~ X1*X2 + (1|PId), data=ws3) Anova.mp(m7, type=3) glmer.mp.con(m7, pairwise ~ X1*X2, adjust="holm")
This fifth and final example is also the reason that the multpois
package was created, since we have
a polytomous response, one between-subjects factor, and one within-subjects factor. This mixed factorial
design is also known as a split-plot design. (Note: Do not confuse mixed factorial designs with mixed-effects
models. The former contain between- and within-subjects factors; the latter contain fixed and random
effects.)
This fictional data is based on the scenario at the beginning of this vignette. Forty respondents, half
adults and half children, were surveyed for their favorite ice cream four times, once per season. Thus,
Age
is a between-subjects factor with two levels {adult, child}
, and Season
is a within-subjects factor
with four levels {fall, winter, spring, summer}
. The polytomous response, Pref
, has three categories:
{vanilla, chocolate, strawberry}
. The PId
factor is repeated across rows, indicating
respondents were queried four times each, once per season.
Let's load and prepare this data set:
data(icecream, package="multpois") icecream$PId = factor(icecream$PId) icecream$Pref = factor(icecream$Pref, levels=c("vanilla","chocolate","strawberry")) icecream$Age = factor(icecream$Age, levels=c("adult","child")) icecream$Season = factor(icecream$Season, levels=c("fall","winter","spring","summer")) contrasts(icecream$Age) <- "contr.sum" contrasts(icecream$Season) <- "contr.sum"
Let's visualize this data set using a mosaic plot:
xt = xtabs( ~ Age + Season + Pref, data=icecream) mosaicplot(xt, main="Pref by Age, Season", las=1, col=c("beige","tan","pink"))
As in the previous example, we can use the multinomial-Poisson trick to analyze repeated measures data with polytomous responses:
m8 = glmer.mp(Pref ~ Age*Season + (1|PId), data=icecream) Anova.mp(m8, type=3)
We have a main effect of Age
and an Age
×Season
interaction but no main effect of Season
. We
can explore this further by graphically depicting response proportions in each age group:
xt = xtabs( ~ Age + Pref, data=icecream) mosaicplot(xt, main="Pref by Age", las=1, col=c("beige","tan","pink"))
The different proportions by Age
clearly emerge, explaining the main effect. Let's also graphically depict the proportions by Season
:
xt = xtabs( ~ Season + Pref, data=icecream) mosaicplot(xt, main="Pref by Season", las=1, col=c("beige","tan","pink"))
Finally, we can again conduct post hoc pairwise comparisons. Note, however, there are many such possible comparisons, and best practice would require us to only conduct those comparisons driven by hypotheses or planned in advance. For example, we might wish to limit our pairwise comparisons to adults vs. children within each season, not across all seasons. In any case, we first conduct all pairwise comparisons just for illustration:
glmer.mp.con(m8, pairwise ~ Age*Season, adjust="holm")
If we wished to compare adults vs. children in each season (fall, winter, spring, and summer), we would first conduct all pairwise comparisons, leaving them uncorrected for multiple comparisons...
glmer.mp.con(m8, pairwise ~ Age*Season, adjust="none")
...and then we would extract the relevant comparisons (rows 4, 22, 11, and 17, respectively), and manually correct their p-values to guard against Type I errors, like so:
p.adjust(c(0.017176, 0.308026, 0.001020, 0.363038), method="holm")
Thus, after correction using Holm's sequential Bonferroni procedure (Holm 1979), we see that adults vs. children in spring are significantly different (p < .05). Looking again at Figure 5 visually confirms this result.
Copyright (C) 2024-2025 Jacob O. Wobbrock <wobbrock@uw.edu>
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.