| ICA_t | R Documentation |
This function evaluates surrogacy in the single-trial causal-inference framework under the t-causal model.
ICA_t(
df,
T0S0,
T1S1,
T0T0 = 1,
T1T1 = 1,
S0S0 = 1,
S1S1 = 1,
T0T1 = seq(-1, 1, by = 0.1),
T0S1 = seq(-1, 1, by = 0.1),
T1S0 = seq(-1, 1, by = 0.1),
S0S1 = seq(-1, 1, by = 0.1)
)
df |
(numeric) is degree of freedom |
T0S0 |
A scalar or vector that specifies the correlation(s) between the surrogate and the true endpoint in the control treatment condition ( |
T1S1 |
A scalar or vector that specifies the correlation(s) between the surrogate and the true endpoint in the experimental treatment condition ( |
T0T0 |
A scalar that specifies the variance of the true endpoint in the control treatment condition |
T1T1 |
A scalar that specifies the variance of the true endpoint in the experimental treatment condition |
S0S0 |
A scalar that specifies the variance of the surrogate endpoint in the control treatment condition |
S1S1 |
A scalar that specifies the variance of the surrogate endpoint in the experimental treatment condition |
T0T1 |
A scalar or vector that contains the correlation(s) between the counterfactuals T0 and T1 |
T0S1 |
A scalar or vector that contains the correlation(s) between the counterfactuals T0 and S1 |
T1S0 |
A scalar or vector that contains the correlation(s) between the counterfactuals T1 and S0 |
S0S1 |
A scalar or vector that contains the correlation(s) between the counterfactuals S0 and S1 |
The multivariate t-distribution has parameters \boldsymbol{\Sigma}, \boldsymbol{\mu}, \nu and is denoted as \mathbf{x} \sim t_p(\boldsymbol{\mu}, \boldsymbol{\Sigma}, \nu).
Mutual information between t-distributed random vectors \mathbf{x}_1 and \mathbf{x}_2 is given by Arellano-Valle et al. (2013):
I_t(\mathbf{x}_1,\mathbf{x}_2) = I_N(\mathbf{x}_1,\mathbf{x}_2) + \zeta(\nu)
The individual causal association under the t-causal model can be computed as:
ICA_t = 1 - e^{-2 I_t(\Delta T, \Delta S)}=1 - e^{-2 I_N(\Delta T, \Delta S)-2\zeta(\nu)}
ICA_t = 1 - (1-ICA_N) e^{-2 \zeta(\nu)}
Note that when \nu approaches infinity, \zeta(\nu) converges to zero and ICA_t=ICA_N.
Total.Num.Matrices: An object of class numeric that contains the total number of matrices that can be formed as based on the user-specified correlations in the function call.
Pos.Def: A data.frame that contains the positive definite matrices that can be formed based on the user-specified correlations. These matrices are used to compute the vector of the \rho_{\Delta} values.
rho: A scalar or vector that contains the individual causal association \rho_{\Delta}
ICA: A scalar or vector that contains the individual causal association under the normal causal model \rho_{\Delta}^2=ICA_N
ICA_t: A scalar or vector that contains the individual causal association under the t-causal model ICA_t
Sigmas: A data.frame that contains the \sigma_{\Delta T} and \sigma_{\Delta S}
Arellano-Valle RB, Conreras-Reyes JE, and Genton MG. (2013). Shannon Entropy and Mutual Information for Multivariate Skew-Elliptical Distributions. Scandinavian Journal of Statistics.
Deliorman, G., Stijven, F., Van der Elst W., Pardo, M. C., & Alonso, A. (2026). The Impact of Model Misspecification on the Individual Causal Association in Surrogate Endpoint Evaluation. Pharmaceutical Statistics
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.