Summary method for multisite simulation diagnostics
Source:R/class-multisitedgp_data.R
summary.multisitedgp_data.RdPrint the full diagnostic report for a multisitedgp_data object —
the four-axis "realized vs. intended" header expanded to include all
Group A (precision and feasibility), Group B (realized dependence on
residual and marginal scales), Group C (distributional fit), and
Group D (shrinkage downstream) diagnostics, plus the threshold-rubric
pass / warn / fail status for each.
Usage
# S3 method for class 'multisitedgp_data'
summary(object, ...)Details
Use summary() when you need to read every diagnostic at once —
typically before a long simulation run, when calibrating a design,
or when investigating why a simulation under-performs vs. the design
target. Use print() for a fast at-a-glance check.
See also
print.multisitedgp_data for the at-a-glance
header; compute_I, realized_rank_corr,
bhattacharyya_coef, ks_distance for
the underlying scalar diagnostics.
Other family-design:
as_tibble.multisitedgp_data(),
design_grid(),
is_multisitedgp_data(),
is_multisitedgp_design(),
multisitedgp_design(),
print.multisitedgp_data(),
update_multisitedgp_design(),
validate_multisitedgp_design()
Examples
dat <- sim_multisite(J = 10L, seed = 1L)
summary(dat)
#> multisiteDGP simulation diagnostics
#> ------------------------------------------------------------
#> A. Realized vs Intended
#> I (informativeness): 0.336 (target N/A) N/A [no target]
#> R (SE heterogeneity): 6.316 (target N/A) N/A [no target]
#> sigma_tau: 0.156 (target 0.200) FAIL [rel=-21.9%]
#> GM(se^2): 0.079 (target N/A) N/A [no target]
#>
#> B. Dependence
#> rank_corr residual: -0.467 (target 0.000) PASS [delta=-0.467]
#> rank_corr marginal: -0.467 (target N/A) N/A [residual target rows only; no finite target; status not assigned]
#> pearson_corr residual: -0.376 (target 0.000) FAIL [delta=-0.376]
#> pearson_corr marginal: -0.376 (target N/A) N/A [residual target rows only; no finite target; status not assigned]
#>
#> C. G shape fit
#> KS distance D_J: 0.200 (target 0.000) PASS [p=0.994]
#> Bhattacharyya BC: 0.200 (target 1.000) FAIL [rel=-80.0%]
#> Q-Q residual: 0.711 (target 0.000) N/A [delta=0.711]
#>
#> D. Operational feasibility
#> mean shrinkage S: 0.345 (target N/A) PASS [no target]
#> avg MOE (95%): 0.571 (target N/A) WARN [no target]
#> feasibility_index: 3.454 (target N/A) FAIL [no target]
#> ------------------------------------------------------------
#> Overall: 3 PASS, 1 WARN, 4 FAIL.
#> Provenance: multisiteDGP 0.1.1 | paradigm=site_size | seed=1 | canonical_hash=f367529f6b9347bf | design_hash=e40e0611ff72f542 | hash_algo=xxhash64 | R=4.6.0 | hooks=none