d_eff_count: Effective Information for Count Outcomes (Poisson)

View source: R/truefind_asymptotic_glm.R

d_eff_countR Documentation

Effective Information for Count Outcomes (Poisson)

Description

Computes d_{\text{eff}} = D / \phi where D is the total expected events and \phi is the dispersion parameter.

Usage

d_eff_count(
  n_sg = NULL,
  event_rate = NULL,
  total_events = NULL,
  dispersion = 1
)

Arguments

n_sg

Integer. Subgroup sample size. Required if total_events is not provided.

event_rate

Numeric. Mean events per patient. Required if total_events is not provided.

total_events

Numeric. Total observed events D. Overrides n_sg * event_rate if provided.

dispersion

Numeric. Overdispersion parameter (1.0 for Poisson, greater than 1 for quasi-Poisson). Default: 1.0.

Details

For Poisson regression with log-offset:

\text{Var}(\hat\beta) = \phi \left(\frac{1}{D_0} + \frac{1}{D_1}\right) \approx \frac{4\phi}{D}

Under proportional hazards, D = d (Cox events), so d_{\text{eff}}^{\text{Poisson}} = d_{\text{eff}}^{\text{Cox}} (Laird and Olivier, 1981).

Value

Numeric. Effective information.

Examples

# From total events
d_eff_count(total_events = 55)

# From sample size and rate
d_eff_count(n_sg = 100, event_rate = 0.8)

# Quasi-Poisson with overdispersion
d_eff_count(total_events = 55, dispersion = 1.5)


forestsearch documentation built on Nov. 15, 2026, 9:06 a.m.