ggbcoverageFromYear: estimate death registration coverage for a single year/sex/region using the GGB method

Description

Given two censuses and an average annual number of deaths in each age class between censuses, we can use stable population assumptions to estimate the degree of underregistration of deaths. The method is based on finding a best-fitting linear relationship between two modeled parameters (right term and left term), but the fit, and resulting coverage estimate, depend on exactly which age range is taken. This function either finds a nice age range for you automatically, or you can specify an exact vector of ages. Called by ggb(). Users probably don't need to call this directly. Just use ggb() instead.

Census dates can be given in a variety of ways: 1) using Date classes, and column names $date1 and $date2 (or an unambiguous character string of the date, like, "1981-05-13") or 2) by giving column names "day1","month1","year1","day2","month2","year2" containing integers. If only year1 and year2 are given, then we assume January 1 dates. If year and month are given, then we assume dates on the first of the month.

Usage

ggbcoverageFromYear(codi, exact.ages = NULL, minA = 15, maxA = 75,
  minAges = 8, deaths.summed = FALSE)

Arguments

codi

data.frame with columns, $pop1, $pop2, $deaths, $date1, $date2, and $age.

exact.ages

optional. use an exact set of ages to estimate coverage.

minA

the minimum of the age range searched. Default 15

maxA

the maximum of the age range searched. Default 75

minAges

the minimum number of adjacent ages needed as points for fitting. Default 8

deaths.summed

logical. is the deaths column given as the total per age in the intercensal period (TRUE). By default we assume FALSE, i.e. that the average annual was given.

Value

a data.frame with columns for the coverage coefficient, and the min and max of the age range on which it is based.