The default package used for estimate_means()
,
estimate_slopes()
and estimate_contrasts()
is
now marginaleffects. You can set your preferred package as
backend using either the backend
argument, or in general by
setting options(modelbased_backend = "marginaleffects")
or
options(modelbased_backend = "emmeans")
.
Deprecated argument and function names have been removed.
Argument fixed
has been removed, as you can fix
predictor at certain values using the by
argument.
Argument transform
is no longer used to determine
the scale of the predictions. Please use predict
instead.
Argument transform
is now used to (back-) transform
predictions and confidence intervals.
Argument method
in estimate_contrasts()
was renamed into comparison
.
All model_*()
alias names have been removed. Use the
related get_*()
functions instead.
The show_data
argument in plot()
defaults to FALSE
.
The "marginaleffects"
backend is now fully
implemented and no longer work-in-progress. You can set your preferred
package as backend using either the backend
argument, or in
general by setting
options(modelbased_backend = "marginaleffects")
or
options(modelbased_backend = "emmeans")
.
All estimate_*()
functions get a
predict
argument, which can be used to modulate the type of
transformation applied to the predictions (i.e. whether predictions
should be on the response scale, link scale, etc.). It can also be used
to predict auxiliary (distributional) parameters.
estimate_means()
and
estimate_contrasts()
get a estimate
argument,
to specify how to estimate over non-focal terms. This results in
slightly different predicted values, each approach answering a different
question.
estimate_contrasts()
gains a backend
argument. This defaults to "marginaleffects"
, but can be
set to "emmeans"
to use features of that package to
estimate contrasts and pairwise comparisons.
estimate_expectation()
and related functions also
get a by
argument, as alternative to create a datagrid for
the data
argument.
Many functions get a verbose
argument, to silence
warnings and messages.
estimate_contrasts()
did not calculate contrasts for
all levels when the predictor of interest was converted to a factor
inside the model formula.
Fixed issue in estimate_contrasts()
when
comparsison
(formerly: method
) was not
"pairwise"
.
3.6
.Fixed issues with printing-methods.
Maintenance release to fix failing tests in CRAN checks.
visualisation_matrix()
has now become an alias
(alternative name) for the get_datagrid()
function, which is implemented in the insight
package.API changes: levels
in
estimate_contrasts
has been replaced by
contrast
. levels
and modulate
are
in general aggregated under at
.
estimate_prediction()
deprecated in favour of
estimate_response()
.
estimate_expectation()
now has
data=NULL
by default.
General overhaul of the package.
Entire refactoring of
visualisation_matrix()
.
Option of standardizing/unstandardizing predictions, contrasts
and means is now available via standardize()
instead of via
options.
Introduction of model_emmeans()
as a wrapper to
easily create emmeans
objects.
estimate_smooth()
transformed into
describe_nonlinear()
and made more explicit.
estimate_link()
now does not transform
predictions on the response scale for GLMs. To keep the previous
behaviour, use the new estimate_relation()
instead. This
follows a change in how predictions are made internally (which now
relies on get_predicted()
,
so more details can be found there).Predicted
is now the name of the predicted column for
Bayesian models (similarly to Frequentist ones), instead of the
centrality index (e.g., Median
).estimate_slope()
now gives an informative error when no
numeric predictor is present.Partial support of formulas.
Refactor the emmeans wrapping.
parameters
package update.NEWS.md
file to track changes to the
package