Learn R Programming

MetaDose (version 1.0.1)

mdbin: Linear and Nonlinear Dose-Response Meta-Regression for Binary Outcomes

Description

Performs linear and/or nonlinear dose-response meta-regression for binary outcomes using study-level event data. The function supports relative risk (`RR`) and odds ratio (`OR`) effect measures and models the association between dose levels and treatment effects.

Usage

mdbin(
  measure = c("RR", "OR"),
  event.e,
  n.e,
  event.c,
  n.c,
  dose,
  data,
  linear = TRUE,
  nonlinear = TRUE,
  x_axis = "Dose",
  y_axis = "Measured Effect",
  knots = c(0.1, 0.5, 0.9)
)

Value

An S3 object of class `dose`, which is a list containing:

linear_model

The fitted linear dose-response meta-regression model.

linear_plot

A plot of the linear dose-response relationship.

nonlinear_model

The fitted nonlinear dose-response meta-regression model.

nonlinear_plot

A plot of the nonlinear dose-response relationship.

Arguments

measure

Character string specifying the effect size measure. Options are "RR" for relative risk or "OR" for odds ratio.

event.e

Numeric vector of numbers of events in the experimental group.

n.e

Numeric vector of sample sizes in the experimental group.

event.c

Numeric vector of numbers of events in the control group.

n.c

Numeric vector of sample sizes in the control group.

dose

Numeric vector of dose levels corresponding to each study.

data

A data frame containing the meta-analysis data.

linear

Logical; if TRUE, a linear dose-response model is fitted.

nonlinear

Logical; if TRUE, a nonlinear dose-response model using restricted cubic splines is fitted.

x_axis

Character string specifying the x-axis label for plots.

y_axis

Character string specifying the y-axis label for plots.

knots

Numeric vector of quantiles used to place knots for the nonlinear restricted cubic spline model.

Author

Ahmed Abdelmageed ahmedelsaeedmassad@gmail.com

Details

The function computes logarithmic effect sizes and corresponding sampling variances from binary outcome data. Linear and/or nonlinear dose-response meta-regression models are then fitted, with nonlinear relationships modeled using restricted cubic splines. Dose-response plots are generated to visualize the fitted associations.

See Also

mdcont for dose-response meta-regression with continuous outcomes.