calcular_taxa: Calculate crude epidemiological rates

In datasus: An Interface to Brazilian Public Health Data

Calculate crude epidemiological rates

Description

Calculates 'eventos / populacao * multiplicador' with explicit validation of counts and denominators. Missing values propagate to the result.

Usage

calcular_taxa(
  eventos,
  populacao,
  multiplicador = 1e+05,
  zero_denominador = c("na", "erro")
)

Arguments

eventos	Non-negative event counts.
populacao	Non-negative population or person-time denominators.
multiplicador	Scale of the rate, default 100,000.
zero_denominador	How to handle zero denominators: '"na"' returns 'NA', while '"erro"' stops.

Value

A numeric vector with the calculated rates.

Examples

calcular_taxa(c(10, 25), c(10000, 20000))
calcular_taxa(25, 20000, multiplicador = 1000)

datasus documentation built on Oct. 7, 2026, 1:07 a.m.