set_confidential_rr3: Specify RR3 Confidentialization

View source: R/bage_mod-functions.R

set_confidential_rr3R Documentation

Specify RR3 Confidentialization

Description

Specify a confidentialization procedure where the outcome variable is randomly rounded to a multiple of 3.

Usage

set_confidential_rr3(mod)

Arguments

mod

An object of class "bage_mod", created with mod_pois(), mod_binom(), or mod_norm().

Details

set_confidential_rr3() can only be used with Poisson and binomial models (created with mod_pois() and mod_binom().)

Random rounding to base 3 (RR3) is a confidentialization technique that is sometimes applied by statistical agencies. The procedure for randomly-rounding an integer value n is as follows:

  • If n is divisible by 3, leave it unchanged

  • If dividing n by 3 leaves a remainder of 1, then round down (subtract 1) with probability 2/3, and round up (add 2) with probability 1/3.

  • If dividing n by 3 leaves a remainder of 1, then round down (subtract 2) with probability 1/3, and round up (add 1) with probability 2/3.

If set_confidential_rr3() is applied to a fitted model, set_confidential_rr3() unfits the model, deleting existing estimates.

Value

A revised version of mod.

See Also

  • confidential Overview of confidentialization procedures currently modeled in bage

  • mod_pois(), mod_binom(), mod_norm() Specify a model for rates, probabilities, or means

Examples

## 'injuries' variable in 'nzl_injuries' dataset
## has been randomly rounded to base 3
mod <- mod_pois(injuries ~ age:sex + ethnicity + year,
                data = nzl_injuries,
                exposure = popn) |>
  set_confidential_rr3() |>
  fit()

bage documentation built on Nov. 5, 2025, 5:33 p.m.