joinrate function

Join ratetables

The function joins two or more objects organized as ratetable by adding a new dimension.

joinrate(tables, dim.name = "country", merge = FALSE)

Arguments

• tables: a list of ratetables. If names are given, they are included as dimnames.
• dim.name: the name of the added dimension.
• merge: if FALSE (default) only the intersect of all years/ages is taken. If TRUE all possible years/ages are included (NOTE: in this case hazards are extrapolated from earlier or later years/ages). This option only works for ratetables with dimensions

Returns

An object of class ratetable.

Details

This function joins two or more ratetable objects by adding a new dimension. The cutpoints of all the rate tables are compared; if merge=FALSE (default) only the common intervals are kept, otherwise if merge=TRUE all intervals are added (and hazards are extrapolated). If the intervals defined by the cutpoints are not of the same length, a warning message is displayed. Each rate table must have the same dimensions.

Examples

#newpop <- joinrate(list(Arizona=survexp.az,Florida=survexp.fl,
#                   Minnesota=survexp.mn),dim.name="state")

References

Package: Pohar M., Stare J. (2006) "Relative survival analysis in R." Computer Methods and Programs in Biomedicine, 81 : 272-278.

Relative survival: Pohar, M., Stare, J. (2007) "Making relative survival analysis relatively easy." Computers in biology and medicine, 37 : 1741-1749.

See Also

survival::ratetable, transrate.hld, transrate.hmd, transrate.