taxa_incidencia: Calculate grouped incidence rates

In datasus: An Interface to Brazilian Public Health Data

Calculate grouped incidence rates

Description

Calculate grouped incidence rates

Usage

taxa_incidencia(
  dados,
  casos,
  populacao,
  grupo = NULL,
  multiplicador = 1e+05,
  confianca = NULL,
  na_rm = FALSE,
  zero_denominador = c("na", "erro")
)

Arguments

dados	A non-empty data frame.
casos	Name of the incident cases column.
populacao	Name of the population or person-time denominator column.
grupo	Optional character vector naming grouping columns.
multiplicador	Positive rate scale, default 100,000.
confianca	Optional confidence level. Exact intervals are available for rates, proportions and case fatality, but not for ratios.
na_rm	Whether rows with a missing numerator or denominator should be removed pairwise within each group. A group containing no complete row remains missing.
zero_denominador	How to handle zero denominators: '"na"' returns 'NA', while '"erro"' stops.

Value

A data frame with aggregated counts and 'taxa_incidencia'.

Examples

dados <- data.frame(ano = c(2024, 2024), casos = c(10, 20),
                    populacao = c(50000, 50000))
taxa_incidencia(dados, "casos", "populacao", grupo = "ano")

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