Skip to content

Commit

Permalink
Add all references, fill in a couple gaps
Browse files Browse the repository at this point in the history
  • Loading branch information
jacob-long committed Jan 7, 2024
1 parent 7551163 commit ebcec91
Show file tree
Hide file tree
Showing 2 changed files with 121 additions and 51 deletions.
87 changes: 87 additions & 0 deletions paper.bib
Original file line number Diff line number Diff line change
Expand Up @@ -58,3 +58,90 @@ @Article{pbkrtest
pages = {1--30},
url = {http://www.jstatsoft.org/v59/i09/},
}

@Manual{marginaleffects,
title = {marginaleffects: Predictions, Comparisons, Slopes, Marginal Means, and Hypothesis
Tests},
author = {Vincent Arel-Bundock},
year = {2023},
note = {R package version 0.17.0},
url = {https://CRAN.R-project.org/package=marginaleffects},
}

@article{sutin2023,
title = {Five-Factor Model Personality Traits and the Trajectory of Episodic Memory: Individual-Participant Meta-Analysis of 471,821 Memory Assessments from 120,640 Participants},
shorttitle = {Five-Factor Model Personality Traits and the Trajectory of Episodic Memory},
author = {Sutin, Angelina R and Brown, Justin and Luchetti, Martina and Aschwanden, Damaris and Stephan, Yannick and Terracciano, Antonio},
date = {2023-03-01},
journaltitle = {The Journals of Gerontology: Series B},
shortjournal = {The Journals of Gerontology: Series B},
volume = {78},
number = {3},
pages = {421--433},
issn = {1758-5368},
doi = {10.1093/geronb/gbac154}
}

@article{urban-wojcik2022,
title = {Diversity of Daily Activities Is Associated with Greater Hippocampal Volume},
author = {Urban-Wojcik, Emily J. and Lee, Soomi and Grupe, Daniel W. and Quinlan, Laurel and Gresham, Lauren and Hammond, Angel and Charles, Susan T. and Lachman, Margie E. and Almeida, David M. and Davidson, Richard J. and Schaefer, Stacey M.},
date = {2022-02-01},
journaltitle = {Cognitive, Affective, \& Behavioral Neuroscience},
shortjournal = {Cogn Affect Behav Neurosci},
volume = {22},
number = {1},
pages = {75--87},
issn = {1531-135X},
doi = {10.3758/s13415-021-00942-5}
}

@article{spalti2023,
title = {Partisanship and Anti-Elite Worldviews as Correlates of Science and Health Beliefs in the Multi-Party System of {{Spain}}},
author = {Spälti, Anna Katharina and Lyons, Benjamin and Stoeckel, Florian and Stöckli, Sabrina and Szewach, Paula and Mérola, Vittorio and Stednitz, Christine and López González, Paola and Reifler, Jason},
date = {2023-08-01},
journaltitle = {Public Understanding of Science},
shortjournal = {Public Underst Sci},
volume = {32},
number = {6},
pages = {761--780},
publisher = {{SAGE Publications Ltd}},
issn = {0963-6625},
doi = {10.1177/09636625231154131}
}

@Article{survey,
year = {2004},
author = {Thomas Lumley},
title = {Analysis of Complex Survey Samples},
journal = {Journal of Statistical Software},
volume = {9},
number = {1},
pages = {1-19},
note = {R package verson 2.2}
}

@article{dumouchel1983,
title = {Using Sample Survey Weights in Multiple Regression Analyses of Stratified Samples},
author = {DuMouchel, William H. and Duncan, Greg J.},
date = {1983-09},
journaltitle = {Journal of the American Statistical Association},
volume = {78},
eprint = {2288115},
eprinttype = {jstor},
pages = {535--543},
issn = {01621459},
doi = {10.2307/2288115}
}

@article{pfeffermann1999,
title = {Parametric and Semi-Parametric Estimation of Regression Models Fitted to Survey Data},
author = {Pfeffermann, Danny and Sverchkov, Michail},
date = {1999},
journaltitle = {Sankhyā: The Indian Journal of Statistics},
volume = {61},
eprint = {25053074},
eprinttype = {jstor},
pages = {166--186},
url = {http://www.jstor.org/stable/25053074},
urldate = {2017-03-09}
}
85 changes: 34 additions & 51 deletions paper.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ authors:
affiliations:
- name: School of Journalism and Mass Communications, University of South Carolina, USA
index: 1
date: 26 October 2023
date: 6 January 2024
bibliography: paper.bib

---
Expand Down Expand Up @@ -58,62 +58,45 @@ for comparing nested/related model specifications. Plots are generated with
`ggplot2` — allowing knowledgeable users to further customize the appearance —
but do not require the user to know how to use `ggplot2`.

To support survey researchers, `jtools` functions generally support the use of
sampling weights and survey design objects created by the `survey` package
[@survey]. To fill in a gap in `survey`'s offerings, it adds `svycor()`, which
calculates survey-weighted correlation matrices for survey design objects.
In addition, `weights_tests()` implements the tests for the ignorability of
sampling weights first devised by @dumouchel1983 and @pfeffermann1999.
In layman's terms, these tests allow researchers to check whether the use of
sampling weights to make data better resemble a population meaningfully change
their statistical results compared to ignoring those weights.

## Alternative software

Other R packages exist to achieve some of these ends. In some cases, `jtools`
is using third-party packages for computation and simply repackaging the results
(e.g., `sandwich` [@sandwich] for robust standard errors and `pbkrtest` for computation of
*p*-values for multilevel models). `modelsummary` provides comparable
functionality to `summ()` and has some advantages, such as a greater range
(e.g., `sandwich` \[@sandwich\] for robust standard errors and `pbkrtest`
\[@pbkrtest\] for computation of
*p*-values for multilevel models). `modelsummary` [@modelsummary] provides
comparable functionality to `summ()` and has some advantages, such as a
greater range
of supported models and more support for exporting to external documents.
`marginaleffects`, `sjPlot`, and `see` offer support for plotting predicted
`marginaleffects` [@marginaleffects], `sjPlot` [@sjplot], and `see` [@see]
offer support for plotting predicted
values from fitted regression models and again have some of their own
advantages, such as more supported model types. There is also overlap in
functionality with the `car` package (e.g., the computation of variance
inflation factors and partial residuals), although `jtools` aims to improve
functionality with the `car` package [@car], like the computation of variance
inflation factors and partial residuals, although `jtools` aims to improve
the user interface and support more model types in some cases.

# Mathematics

Single dollars ($) are required for inline mathematics e.g. $f(x) = e^{\pi/x}$

Double dollars make self-standing equations:

$$\Theta(x) = \left\{\begin{array}{l}
0\textrm{ if } x < 0\cr
1\textrm{ else}
\end{array}\right.$$

You can also use plain \LaTeX for equations
\begin{equation}\label{eq:fourier}
\hat f(\omega) = \int_{-\infty}^{\infty} f(x) e^{i\omega x} dx
\end{equation}
and refer to \autoref{eq:fourier} from text.

# Citations

Citations to entries in paper.bib should be in
[rMarkdown](http://rmarkdown.rstudio.com/authoring_bibliographies_and_citations.html)
format.

If you want to cite a software repository URL (e.g. something on GitHub without a preferred
citation) then you can do it with the example BibTeX entry below for @fidgit.

For a quick reference, the following citation commands can be used:
- `@author:2001` -> "Author et al. (2001)"
- `[@author:2001]` -> "(Author et al., 2001)"
- `[@author1:2001; @author2:2001]` -> "(Author1 et al., 2001; Author2 et al., 2002)"

# Figures

Figures can be included like this:
![Caption for example figure.\label{fig:example}](figure.png)
and referenced from text using \autoref{fig:example}.

Figure sizes can be customized by adding an optional second parameter:
![Caption for example figure.](figure.png){ width=20% }

# Acknowledgements

We acknowledge contributions from Brigitta Sipocz, Syrtis Major, and Semyeong
Oh, and support from Kathryn Johnston during the genesis of this project.
## Real-world use

At the time of writing, Google Scholar has tracked 556 references to `jtools`.
These are predominantly, but not solely, in the social sciences, such as
psychology, communication, and political science. For example, @sutin2023
uses `summ()` to calculate degrees of freedom for a multilevel model in a
study of personality and aging. @urban-wojcik2022 also use `summ()`, in this
case to summarize regression models with robust standard errors in their study
of physical activity and the hippocampus. @kraft2022 generate plotted regression
summaries with `plot_coefs()`. Finally, @spalti2023 use `weights_tests()` to
assess the sensitivity of their estimates to the influence of survey sampling
weights.

# References

0 comments on commit ebcec91

Please # to comment.