README.Rmd

---
output: github_document
---

<!-- README.md is generated from README.Rmd. Please edit that file -->

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```

# discursive

<!-- badges: start -->
<!-- badges: end -->

This package implements a simple but powerful framework to measure political sophistication based on open-ended survey responses. Discursive sophistication captures the complexity of individual attitude expression by quantifying its relative size, range, and constraint. For more information on the measurement approach see: Kraft, Patrick W. 2023. "Women Also Know Stuff: Challenging the Gender Gap in Political Sophistication." American Political Science Review (forthcoming).

## Installation

`discursive` is now available on CRAN! You can install the latest version with:

``` r
install.packages("discursive")
```


Alternatively, you can install the development version of discursive from [GitHub](https://github.com/) with:

``` r
# install.packages("devtools")
devtools::install_github("pwkraft/discursive")
```

## Example

```{r example}
library(discursive)
cces$discursive <- discursive(data = cces,
                              openends = c(paste0("oe0", 1:9), "oe10"),
                              meta = c("age", "educ_cont", "pid_cont", "educ_pid", "female"),
                              args_prepDocuments = list(lower.thresh = 10, verbose = FALSE),
                              args_stm = list(K = 25, seed = 12345, verbose = FALSE),
                              dictionary = dict_sample, progress = FALSE)$output$discursive
head(cces)
```

<!-- What is special about using `README.Rmd` instead of just `README.md`? You can include R chunks like so: -->

<!-- ```{r cars} -->
<!-- summary(cars) -->
<!-- ``` -->

<!-- You'll still need to render `README.Rmd` regularly, to keep `README.md` up-to-date. `devtools::build_readme()` is handy for this. You could also use GitHub Actions to re-render `README.Rmd` every time you push. An example workflow can be found here: <https://github.com/r-lib/actions/tree/v1/examples>. -->

<!-- You can also embed plots, for example: -->

<!-- ```{r pressure, echo = FALSE} -->
<!-- plot(pressure) -->
<!-- ``` -->

<!-- In that case, don't forget to commit and push the resulting figure files, so they display on GitHub and CRAN. -->