aapc.multiints: Trend summary measures for multiple selected intervals
In JPSurv: Joinpoint Model for Relative and Cause-Specific Survival
View source: R/joinpoint.surv.new.R
aapc.multiints R Documentation
Trend summary measures for multiple selected intervals
Description
A function that returns the trend summary measures including the
Absolute Change in Survival (ACS), the Relative Change in Survival (RCS)
and the Relative Change in Hazard (RCH) for each joinpoint segment given multiple selected intervals.
It can also return the Weighted Average Abosulte Change in Survival for the user-specified ACS year range.
Usage
aapc.multiints(fit, type = "AbsChgSur", int.select = NULL,
ACS.range = NULL, ACS.out = NULL)
Arguments
fit
Joinpoint object with predicted values and joinpoint model selections.
type
Type of trend summary measure.
Supported measures are:
RelChgHaz - Hazard of cancer death,
AbsChgSur - Cumulative Relative Survival Average Annual Absolute Change.
RelChgSur - Cumulative Relative Survival Average Annual Relative Change. The default is AbsChgSur.
int.select
The single or multiple interval values selected for the trend measures calculation. The default is NULL.
ACS.range
It is needed for type="AbsChgSur" only. The minimum and maximum of the year range specified for the Average Absolute Change in Survival trend measure.
The default is NULL. If ACS.range=NULL, the average absolute change in survival for joinpoint segments will be returned.
Otherwise, the weighted average absolute change in survival for the desired range of years along with the the average absolute change in survival
for joinpoint segments will be produced.
Note that, the ACS.range should be within the entire range of data.
ACS.out
It is used to specify which ACS trend results will be returned when type="AbsChgSur". ACS.out can be defined as "user" or "both".
If ACS.range=NULL, ACS.out should always be NULL and the ACS trend results between joinpoints will be returned. If ACS.range is the year range, the ACS trend measure results between the selected years will be returned when
ACS.out="user" and the ACS trend results for both between joinpoints and user-selected years will be returned when ACS.out="both". The default is ACS.out=NULL.
Value
A list of data frames corresponding to each interval from int.select.
Each data frame contains the columns start.year, end.year, estimate,
std.error, lowCI, upCI for the
estimates, standard errors, and confidence interval of the trend summary measure.
Author(s)
Fanni Zhang <zhangf@imsweb.com>
See Also
aapc
Examples
data("fit1", package="JPSurv")
aapc.multiints(fit1, type="RelChgHaz",int.select=c(1,3,5))
JPSurv documentation built on June 8, 2025, 12:11 p.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
View source: R/joinpoint.surv.new.R
| aapc.multiints | R Documentation |
Trend summary measures for multiple selected intervals
Description
A function that returns the trend summary measures including the Absolute Change in Survival (ACS), the Relative Change in Survival (RCS) and the Relative Change in Hazard (RCH) for each joinpoint segment given multiple selected intervals. It can also return the Weighted Average Abosulte Change in Survival for the user-specified ACS year range.
Usage
aapc.multiints(fit, type = "AbsChgSur", int.select = NULL,
ACS.range = NULL, ACS.out = NULL)
Arguments
fit |
Joinpoint object with predicted values and joinpoint model selections. |
type |
Type of trend summary measure. Supported measures are: RelChgHaz - Hazard of cancer death, AbsChgSur - Cumulative Relative Survival Average Annual Absolute Change. RelChgSur - Cumulative Relative Survival Average Annual Relative Change. The default is AbsChgSur. |
int.select |
The single or multiple interval values selected for the trend measures calculation. The default is NULL. |
ACS.range |
It is needed for type="AbsChgSur" only. The minimum and maximum of the year range specified for the Average Absolute Change in Survival trend measure. The default is NULL. If ACS.range=NULL, the average absolute change in survival for joinpoint segments will be returned. Otherwise, the weighted average absolute change in survival for the desired range of years along with the the average absolute change in survival for joinpoint segments will be produced. Note that, the ACS.range should be within the entire range of data. |
ACS.out |
It is used to specify which ACS trend results will be returned when type="AbsChgSur". ACS.out can be defined as "user" or "both". If ACS.range=NULL, ACS.out should always be NULL and the ACS trend results between joinpoints will be returned. If ACS.range is the year range, the ACS trend measure results between the selected years will be returned when ACS.out="user" and the ACS trend results for both between joinpoints and user-selected years will be returned when ACS.out="both". The default is ACS.out=NULL. |
Value
A list of data frames corresponding to each interval from int.select.
Each data frame contains the columns start.year, end.year, estimate,
std.error, lowCI, upCI for the
estimates, standard errors, and confidence interval of the trend summary measure.
Author(s)
Fanni Zhang <zhangf@imsweb.com>
See Also
aapc
Examples
data("fit1", package="JPSurv")
aapc.multiints(fit1, type="RelChgHaz",int.select=c(1,3,5))
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.