From ebcec91bbf5bf6ce3844bb230fddacf7cb19e53f Mon Sep 17 00:00:00 2001 From: Jacob Long Date: Sat, 6 Jan 2024 22:50:31 -0500 Subject: [PATCH] Add all references, fill in a couple gaps --- paper.bib | 87 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ paper.md | 85 ++++++++++++++++++++++------------------------------- 2 files changed, 121 insertions(+), 51 deletions(-) diff --git a/paper.bib b/paper.bib index c6889dca..664fcd3b 100644 --- a/paper.bib +++ b/paper.bib @@ -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} +} diff --git a/paper.md b/paper.md index 8886bae6..9ec6c20d 100644 --- a/paper.md +++ b/paper.md @@ -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 --- @@ -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 \ No newline at end of file