Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[paper] writing #332

Open
wants to merge 44 commits into
base: main
Choose a base branch
from
Open
Changes from 1 commit
Commits
Show all changes
44 commits
Select commit Hold shift + click to select a range
e8fb785
Update paper.md
DominiqueMakowski Jan 13, 2025
c242f84
Update paper.md
DominiqueMakowski Jan 13, 2025
a52afbb
marginal
DominiqueMakowski Jan 13, 2025
0acb491
backends
DominiqueMakowski Jan 13, 2025
0985a4f
getting somewhere
DominiqueMakowski Jan 13, 2025
16add3a
Merge branch 'main' into paper
strengejacke Jan 13, 2025
3a919b1
Merge branch 'main' into paper
DominiqueMakowski Jan 14, 2025
51178f6
Merge branch 'main' into paper
strengejacke Jan 15, 2025
c5f547b
Merge branch 'main' into paper
strengejacke Jan 18, 2025
e1b7406
Merge branch 'main' into paper
strengejacke Jan 19, 2025
ad7aa9b
Update paper.md
DominiqueMakowski Jan 19, 2025
b4856fb
Merge branch 'main' into paper
strengejacke Jan 28, 2025
5ef34a0
Technical details
mattansb Jan 29, 2025
f3c8ba9
Merge branch 'main' into paper
strengejacke Jan 29, 2025
76317b1
whitespace
strengejacke Jan 29, 2025
5db5e0d
no bib file yet
strengejacke Jan 29, 2025
7548abb
rephrase statement of need
strengejacke Jan 29, 2025
69e54f6
minor
strengejacke Jan 29, 2025
d4592d5
...
strengejacke Jan 29, 2025
4f078a3
Merge branch 'main' into paper
strengejacke Jan 30, 2025
72044f1
minor
DominiqueMakowski Feb 3, 2025
1c5018a
Merge branch 'main' into paper
strengejacke Feb 5, 2025
0f27e1e
Merge branch 'main' into paper
strengejacke Feb 5, 2025
4919bbe
Update paper.md
DominiqueMakowski Feb 5, 2025
243e2d2
Update paper.md
DominiqueMakowski Feb 5, 2025
4acf169
Merge branch 'main' into paper
rempsyc Feb 7, 2025
2b61c3c
rmd, references, pdf, etc.
rempsyc Feb 8, 2025
056d875
Merge branch 'main' into paper
DominiqueMakowski Feb 9, 2025
a62af74
Affs: Daniel as senior
DominiqueMakowski Feb 9, 2025
067592c
fix pdf
DominiqueMakowski Feb 9, 2025
e0c853e
fix yaml
strengejacke Feb 9, 2025
a93ea5a
statement of need
strengejacke Feb 9, 2025
145ac6a
key concepts
strengejacke Feb 9, 2025
2c9afbc
minor
strengejacke Feb 9, 2025
c4f70d3
marginal effects
strengejacke Feb 9, 2025
1a0df5c
turn link-citations to false to fix references
rempsyc Feb 9, 2025
81ceaec
Update paper.Rmd
mattansb Feb 9, 2025
3fb8754
Merge branch 'main' into paper
strengejacke Feb 10, 2025
1d483f5
minor intro tweaks
DominiqueMakowski Feb 10, 2025
4874734
Merge branch 'main' into paper
strengejacke Feb 10, 2025
e66d98b
contribute writing
rempsyc Feb 10, 2025
8e8da1b
Merge branch 'main' into paper
rempsyc Feb 10, 2025
11647cc
Merge branch 'main' into paper
rempsyc Feb 11, 2025
0706a4f
revise
strengejacke Feb 11, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
rephrase statement of need
  • Loading branch information
strengejacke committed Jan 29, 2025
commit 7548abbd0f5411083c91a912b37e0c8f58dd7c13
9 changes: 3 additions & 6 deletions paper/paper.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,13 +41,10 @@ The replication crisis (REF) and methodological revolution(s) (Makowski & Waggon
In line with these efforts, new tools have been created to facilitate the direct usage and reporting of statistical models. For instance, the `easystats` collection of R packages has been developed to help researchers "tame, discipline, and harness" the power of statistical models. Existing packages are dedicated to model parameters (e.g., the `parameters` package; REF), predictive performance (e.g., the `performance` package; REF) or effect importance (e.g., the `effectsize` package; REF).

**But there is even more power hidden inside models!**
Their fundamental nature - being a statistical link between an outcome $y$ and predictor variables $X$ - enables the generation predictions for any combination of predictors - typically observed combinations, but often unobserved (counter-factual) ones.
These predictions, in turn, can be used to estimate values and effects any levels, as well as contrasting them, making it possible to visualize the model's behaviour in a more meaningful and comprehensive way and answering a wide range of research questions.
Their fundamental nature - being a statistical link between an outcome $y$ and predictor variables $X$ - enables the generation of predictions for any combination of predictors - typically observed combinations, but often unobserved (counter-factual) ones.
These predictions, in turn, can be used to estimate expected values of the outcome and predictor effects of any levels, as well as contrasting them, making it possible to visualize the model's behaviour in a more meaningful and comprehensive way and answering a wide range of research questions.

This currently underused potential is what the `modelbased` package aims to unlock.
It provides a unified interface to extract marginal means, marginal effects, and model predictions from a wide range of statistical models.
It is built on top of the `emmeans` (REF) and `marginaleffects` (REF) packages, which are the two most popular packages for extracting these quantities of interest from statistical models.
In line with the `easystats`' *raison d'être*, the `modelbased` package is designed to be user-friendly, with a focus on simplicity and flexibility.
The two probably most popular R packages for extracting these quantities of interest from statistical models are `emmeans` (REF) and `marginaleffects` (REF). These packages are enormously feature rich and (almost) cover all imaginable needs for post-hoc analysis of statistical models. However, these packages are not always easy to use, especially for users who are not familiar with the underlying statistical concepts. The `modelbased` package aims to unlock this currently underused potential by providing a unified interface to extract marginal means, marginal effects, contrasts, comparisons and model predictions from a wide range of statistical models. It is built on top of the two aforementioned `emmeans` and `marginaleffects` packages. In line with the `easystats`' *raison d'être*, the `modelbased` package is designed to be user-friendly, with a focus on simplicity and flexibility.


# Key concepts
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We might add a short sentence clarifying the conceptual differences between predictions and marginal means?

Expand Down
Loading