plot_respondents

Plot the distribution of estimated respondent positions from an HBAM model.

Perform hierarchical Bayesian Aldrich-McKelvey scaling using Hamiltonian Monte
Carlo via 'Stan'. Aldrich-McKelvey ('AM') scaling is a method for estimating the ideological
positions of survey respondents and political actors on a common scale using positional survey
data. The hierarchical versions of the Bayesian 'AM' model included in this package outperform
other versions both in terms of yielding meaningful posterior distributions for respondent
positions and in terms of recovering true respondent positions in simulations. The package
contains functions for preparing data, fitting models, extracting estimates, plotting key
results, and comparing models using cross-validation. The original version of the default
model is described in Bølstad (2024) <doi:10.1017/pan.2023.18>.

Jørgen Bølstad

hbamr

Hierarchical Bayesian Aldrich-McKelvey Scaling via 'Stan'

plot_respondents function

<dl><dt>object</dt>
<dd>An instance of class <code>stanfit</code> produced by <code>hbam()</code>.</dd>
<dt>inc_stimuli</dt>
<dd>Logical: Should estimated stimulus positions also be shown?</dd>
<dt>n_draws</dt>
<dd>Integer specifying the number of posterior draws to use when illustrating the uncertainty of the population distribution. Defaults to 15.</dd>
<dt>color</dt>
<dd>Color of lines illustrating uncertainty.</dd>
<dt>fill</dt>
<dd>Fill color for density plots.</dd>
<dt>alpha_color</dt>
<dd>Number in [0,1]: Inverse level of transparency for line color.</dd>
<dt>alpha_fill</dt>
<dd>Number in [0,1]: Inverse level of transparency for fill color.</dd>
<dt>seed</dt>
<dd>A positive integer specifying an optional seed for reproducibility. The seed is used to select respondent position draws for illustrating uncertainty.</dd></dl>

Arguments

Plot estimated respondent positions — plot_respondents

<dl>

<dt>object</dt>
<dd>An instance of class <code>stanfit</code> produced by <code>hbam()</code>.</dd>


<dt>inc_stimuli</dt>
<dd>Logical: Should estimated stimulus positions also be shown?</dd>


<dt>n_draws</dt>
<dd>Integer specifying the number of posterior draws to use when illustrating the uncertainty of the population distribution. Defaults to 15.</dd>


<dt>color</dt>
<dd>Color of lines illustrating uncertainty.</dd>


<dt>fill</dt>
<dd>Fill color for density plots.</dd>


<dt>alpha_color</dt>
<dd>Number in [0,1]: Inverse level of transparency for line color.</dd>


<dt>alpha_fill</dt>
<dd>Number in [0,1]: Inverse level of transparency for fill color.</dd>


<dt>seed</dt>
<dd>A positive integer specifying an optional seed for reproducibility. The seed is used to select respondent position draws for illustrating uncertainty.</dd>

</dl>

plot_respondents: Plot estimated respondent positions

Description

Usage

Value

Arguments