Compares groups of right-censored survival data by nonparametric tests (D.A. Murray).

### Options

`PRINT` = string token |
Controls printed output (`test` ); default `test` |
---|---|

`METHOD` = string tokens |
Types of test required (`logrank` , `breslow` , `petoprentice` , `taroneware` ); default `logr` , `bres` , `peto` , `taro` |

`BLOCKS` = factor |
Factor specifying groupings for a stratified test; default `*` i.e. none |

### Parameters

`TIMES` = variates |
Observed timepoints |
---|---|

`CENSORED` = variates |
Variate specifying whether the corresponding element of `TIMES` is censored (1) or not (0) |

`GROUPS` = factors |
Factor specifying the different groups |

`TESTS` = pointers |
Pointer to variates (length 3) to save test statistic, d.f. and probability value for each chosen method |

### Description

`RSTEST`

compares two or more groups of right-censored survival data using nonparametric tests. The type of test to be performed is specified by the `METHOD`

option, with settings `logrank`

, `breslow`

, `petoprentice`

and `taroneware`

.

The observed timepoints or the timepoints at which censoring took place are specified using the `TIMES`

parameter. The `CENSORED`

parameter specifies a variate containing the value one if the corresponding element of `TIMES`

is censored or zero if it was not. `CENSORED`

can be omitted if there was no censoring. The groups to be compared are indicated using the `GROUPS`

parameter. The `BLOCKS`

option can be used to specify a factor to indicate different groupings for a stratified test, for example these might represent different centres or laboratories.

The `TESTS`

parameter allows the statistics to be saved in a pointer to a set of variates (length 3) for each of the chosen methods containing the statistic, its degrees of freedom and probability level. If you are saving the tests you may want to set option `PRINT=*`

to stop them being printed.

Options: `PRINT`

, `METHOD`

, `BLOCKS`

.

Parameters: `TIMES`

, `CENSORED`

, `GROUPS`

, `TESTS`

.

### Method

The log-rank and Wilcoxon (Breslow) tests are calculated according to the method outlined in Chapter 2 of Collet (1994). The Wilcoxon (Peto-Prentice) and Tarone-Ware tests are evaluated using the method detailed in Section 11.1.2 of Collet (1994).

### Action with `RESTRICT`

The input variates and factors may be restricted identically. The tests are based only on the units not excluded by the restriction.

### Reference

Collett, D. (1994). *Modelling Survival Data in Medical Research*. Chapman & Hall, London.

### See also

Procedures: `KAPLANMEIER`

, `RLIFETABLE`

, `RPHFIT`

, `RPROPORTIONAL`

, `RSURVIVAL`

.

Commands for: Survival analysis.

### Example

CAPTION 'RSTEST example',\ !t('Survival times of melanoma patients in two treatment groups',\ 'stratified by age-group (Collet 1994, page 48).'); STYLE=meta,plain VARIATE [NVALUES=30] Day, Censor READ Day,Censor 19 0 24 1 8 0 17 1 17 1 34 1 34 1 4 0 17 1 10 0 5 0 27 1 21 1 18 1 16 1 7 0 12 1 24 0 8 0 8 1 8 0 11 1 23 1 12 1 15 1 8 1 8 1 25 1 8 0 11 1 : FACTOR [LEVELS=3;LABELS=!t('21_40','41_60','61_')] AgeGroup;\ VALUES=!(6(1),3(2),2(3),9(1),7(2),3(3)) FACTOR [LEVELS=2;LABELS=!t('BCG','c.parvum')] Treat;\ VALUES=!(11(1),19(2)) RSTEST Day; CENSORED=Censor; GROUPS=Treat RSTEST [METHOD=logrank; BLOCKS=AgeGroup] Day; CENSORED=Censor; GROUPS=Treat