Output Files

PhenoCluster writes all results to the configured output directory (default: results/).

Main outputs

File	Description
analysis_report.html	Comprehensive interactive HTML report with all results and visualisations
cluster_statistics.json	Phenotype sizes, feature distributions, classification quality metrics
outcome_results.json	Odds ratios with confidence intervals and FDR-corrected p-values
survival_results.json	Kaplan-Meier estimates, Nelson-Aalen curves, and Cox PH hazard ratios with confidence intervals
multistate_results.json	Transition hazard ratios, state occupation probabilities, and pathway analysis
data/model_fit_metrics.csv	Information criteria (BIC, AIC, etc.), entropy, and average posterior probabilities
data/phenotypes_data.csv	Original dataset augmented with phenotype assignments
data/posterior_probabilities.csv	Posterior class membership probabilities per patient
results/model_selection_summary.json	Model selection comparison table and best model info
results/feature_importance.json	Feature characterisation per phenotype (effect sizes, dominant categories)
results/validation_report.json	Internal validation metrics (train/test log-likelihood, cluster proportions)
results/stability_results.json	Consensus clustering stability metrics
results/split_info.json	Train/test split details (sample counts, stratification)
results/external_validation_results.json	External validation results (when external_validation.enabled: true)
phenocluster.log	Pipeline execution log (when logging.log_to_file: true)
artifacts/	Cached intermediate results for incremental re-runs

Visualisations

All plots are saved in the configured format (default: interactive HTML via Plotly). PhenoCluster uses the colorblind-safe Wong (2011) palette.

Plot	Description
Model selection	Information criterion (e.g. BIC) vs number of clusters with best-k annotation
Phenotype size distribution	Bar chart of patient counts per phenotype
Classification quality	Posterior probability distributions per phenotype
Continuous heatmap	Z-score standardised continuous features by phenotype
Categorical heatmap	Within-phenotype proportions for categorical features
Forest plots (OR)	Odds ratios with confidence interval bars
Forest plots (HR)	Hazard ratios with confidence interval bars
Kaplan-Meier curves	Survival curves per phenotype with step-function interpolation
Nelson-Aalen curves	Cumulative hazard estimates per phenotype
Cumulative incidence functions	Transition-specific hazard curves per transition
State occupation probabilities	Time-varying probability of being in each state
Pathway frequency	Most common clinical pathways from Monte Carlo simulation