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)
)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}\)
(numeric) is degree of freedom \(\nu\). The maximum value for df is 342. When df exceeds this threshold, the model behavior aligns with the Individual Causal Association (ICA) under the normal causal model.
A scalar or vector that specifies the correlation(s) between the surrogate and the true endpoint in the control treatment condition (\(\rho_{T0S0}\))
A scalar or vector that specifies the correlation(s) between the surrogate and the true endpoint in the experimental treatment condition (\(\rho_{T1S1}\))
A scalar that specifies the variance of the true endpoint in the control treatment condition
A scalar that specifies the variance of the true endpoint in the experimental treatment condition
A scalar that specifies the variance of the surrogate endpoint in the control treatment condition
A scalar that specifies the variance of the surrogate endpoint in the experimental treatment condition
A scalar or vector that contains the correlation(s) between the counterfactuals T0 and T1
A scalar or vector that contains the correlation(s) between the counterfactuals T0 and S1
A scalar or vector that contains the correlation(s) between the counterfactuals T1 and S0
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\).
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