Learn R Programming

BuyseTest (version 1.3.2)

BuyseTest_cpp: C++ function performing the pairwise comparison over several endpoints.

Description

BuyseTest_Gehan_cpp and BuyseTest_PetoEfron_cpp functions calls for each endpoint and each strata the pairwise comparison function suited to the type of endpoint and store the resuts.

Usage

GPC_cpp(Treatment, Control, threshold, survEndpoint, delta_Treatment,
  delta_Control, D, returnIndex, strataT, strataC, n_strata, n_TTE, Wscheme,
  index_survivalM1, threshold_TTEM1, list_survivalT, list_survivalC, methodTTE,
  correctionTTE, neutralAsUninf, keepComparison)

Arguments

Treatment

A matrix containing the values of each endpoint (in columns) for the treatment group (in rows). const arma::mat&.

Control

A matrix containing the values of each endpoint (in columns) for the control group (in rows). const arma::mat&.

threshold

Store the thresholds associated to each endpoint. const NumericVector&. Must have length D. The threshold is ignored for binary endpoints. Must have D columns.

survEndpoint

Does each endpoint is a time to event. const LogicalVector&. Must have length D.

delta_Treatment

A matrix containing in the type of event (0 censoring, 1 event) for each TTE endpoint (in columns) and treatment observations (in rows). const arma::mat& containing binary integers. Must have n_TTE columns. Ignored if n_TTE equals 0.

delta_Control

A matrix containing the nature of observations in the control group (in rows) (0 censoring, 1 event) for each TTE endpoint (in columns) . const arma::mat& containing binary integers. Must have n_TTE columns. Ignored if n_TTE equals 0.

D

The number of endpoints. Strictly positive const int.

returnIndex

Should the indexes of the neutral or uninformative pairs be returned. const bool.

strataT

A list containing the indexes of treatment observations belonging for each strata. List& of vector containing positive integers.

strataC

A list containing the indexes of control observations belonging for each strata. List& of vector containing positive integers.

n_strata

The number of strata . Strictly positive const int.

n_TTE

The number of time-to-event endpoints. Positive const int.

Wscheme

The matrix describing the weighting strategy. For each endpoint (except the first) in column, weights of each pair are initialized at 1 and multiplied by the weight of the endpoints in rows where there is a 1. const arma::mat&. Must have n_TTE lines and D-1 columns.

index_survivalM1

The position, among all the survival endpoints, of the last same endpoint (computed with a different threshold). If it is the first time that the TTE endpoint is used it is set to -1. const IntegerVector. Must have length n_TTE.

threshold_TTEM1

The previous latest threshold of each TTE endpoint. When it is the first time that the TTE endpoint is used it is set to -1. const NumericVector. Must have length n_TTE.

list_survivalT

A list of matrix containing the survival estimates (-threshold, 0, +threshold ...) for each event of the treatment group (in rows). List&. Must have length n_TTE. Each matrix must have 3 (if method is Peto, only one survival function is computed) or 11 (if method is Efron or Peron, two survival functions are computed) columns. Ignored if method is Gehan.

list_survivalC

A list of matrix containing the survival estimates (-threshold, 0, +threshold ...) for each event of the control group (in rows). List&. Must have length n_TTE. Each matrix must have 3 (if method is Peto) or 11 (if method is Efron or Peron) columns. Ignored if method is Gehan.

methodTTE

The type of method used to compare censored pairs (1 Peto, 2 Efron, 3 Peron).

correctionTTE

Should the uninformative weight be re-distributed to favorable and unfavorable?

neutralAsUninf

Should paired classified as neutral be re-analyzed using endpoints of lower priority? logical.

keepComparison

Should the result of each pairwise comparison be kept? logical.