Counter-matched design

Description

Declares a counter-matched nested case-control sample: a stratified risk-set design in which controls are sampled to differ from the case on a surrogate of exposure, balancing each sampled risk set across exposure strata. The analysis is a weighted Cox partial likelihood that carries the counter-matching inclusion weights.

Usage

counter_matched(strata, time, ratio = NULL)

Arguments

strata A non-empty character vector naming the counter-matching surrogate stratum column(s).
time A single character string naming the event/entry time column that defines the risk sets.
ratio NULL or a single whole number >= 1. Controls sampled per case within the counter-matched strata.

Value

A matchatr_design object of type “counter_matched” carrying the strata, time, and ratio, with a weight_spec flagged for counter-matching weights.

See Also

nested_cc(), matcha()

Other design constructors: case_cohort(), matched_cc(), nested_cc(), two_phase(), unmatched_cc()

Examples

library("matchatr")

counter_matched(strata = "exposure_surrogate", time = "t")
<matchatr_design>
 Type:       Counter-matched
 Strata:     exposure_surrogate
 Time:       t
 Weights:    counter-matching