Correlation with a Simulator-Defined Target — rri_latent

Computes a descriptive correlation between per-sample RRI and a prescribed simulator target. This is an internal simulation benchmark and is not predictive accuracy, empirical validation or recovery of a true latent state.

Usage

rri_latent_correlation(
  res,
  latent_truth,
  method = c("pearson", "spearman", "kendall")
)

Arguments

res: An object returned by rri_pipeline_st().
latent_truth: Numeric simulator-target vector. The legacy argument name is retained for compatibility.
method: Correlation method. One of "pearson", "spearman", or "kendall".

Value

A single numeric correlation coefficient.

Details

This function is designed for simulation benchmarking. In empirical datasets, no known latent state exists and this metric should not be used.

Examples

# \donttest{
  sim <- simulate_redox_holobiont(seed = 1)
  res <- rri_pipeline_st(sim$ROS_flux, sim$Eh_stability)
#> Warning: Unanchored latent axes have arbitrary signs; RRI is exploratory, not directionally validated resilience.
#> Warning: Excluding simulator-derived hidden columns from scoring: Cacc_EAC, Cacc_EDC, Cacc_total, Cacc_fraction, net_oxidative_balance, alpha_accept, alpha_donate, k_accept_h, k_donate_h
  rri_latent_correlation(res, sim$latent_truth)
#> [1] -0.7202595
# }