construction_helpers: Construction Helpers

In cardx: Extra Analysis Results Data Utilities

Construction Helpers

Description

These functions help construct calls to various types of models.

Usage

construct_model(data, ...)

## S3 method for class 'data.frame'
construct_model(
  data,
  formula,
  method,
  method.args = list(),
  package = "base",
  env = caller_env(),
  ...
)

## S3 method for class 'survey.design'
construct_model(
  data,
  formula,
  method,
  method.args = list(),
  package = "survey",
  env = caller_env(),
  ...
)

reformulate2(
  termlabels,
  response = NULL,
  intercept = TRUE,
  env = parent.frame(),
  pattern_term = NULL,
  pattern_response = NULL
)

bt(x, pattern = NULL)

bt_strip(x)

Arguments

data	construct_model.data.frame() (data.frame) a data frame construct_model.survey.design() (survey.design) a survey design object
...	These dots are for future extensions and must be empty.
formula	(formula) a formula
method	(string) string of function naming the function to be called, e.g. "glm". If function belongs to a library that is not attached, the package name must be specified in the package argument.
method.args	(named list) named list of arguments that will be passed to method. Note that this list may contain non-standard evaluation components. If you are wrapping this function in other functions, the argument must be passed in a way that does not evaluate the list, e.g. using rlang's embrace operator {{ . }}.
package	(string) string of package name that will be temporarily loaded when function specified in method is executed.
env	The environment in which to evaluate expr. This environment is not applicable for quosures because they have their own environments.
termlabels	character vector giving the right-hand side of a model formula. Cannot be zero-length.
response	character string, symbol or call giving the left-hand side of a model formula, or NULL.
intercept	logical: should the formula have an intercept?
x	(character) character vector, typically of variable names
pattern, pattern_term, pattern_response	DEPRECATED

Details

• construct_model(): Builds models of the form ⁠method(data = data, formula = formula, method.args!!!)⁠. If the package argument is specified, that package is temporarily attached when the model is evaluated.

• reformulate2(): This is a copy of reformulate() except that variable names that contain a space are wrapped in backticks.

• bt(): Adds backticks to a character vector.

• bt_strip(): Removes backticks from a string if it begins and ends with a backtick.

Value

depends on the calling function

Examples

construct_model(
  data = mtcars,
  formula = am ~ mpg + (1 | vs),
  method = "glmer",
  method.args = list(family = binomial),
  package = "lme4"
) |>
  broom.mixed::tidy()

construct_model(
  data = mtcars |> dplyr::rename(`M P G` = mpg),
  formula = reformulate2(c("M P G", "cyl"), response = "hp"),
  method = "lm"
) |>
  ard_regression() |>
  dplyr::filter(stat_name %in% c("term", "estimate", "p.value"))

cardx documentation built on Sept. 11, 2024, 9:12 p.m.