figures_v2/VISUAL_PLAN.md

# figures_v2 visual plan

This plan targets compact ACM/SIGIR/KDD-style figures for the paper "Citation-Aware High-Order Graph Recommendation for Academic Paper Reading Prediction".

| Figure ID | Paper position | Claim | Chart type | Data source | Main text | Reconstruction strategy |
| --------- | -------------- | ----- | ---------- | ----------- | --------- | ----------------------- |
| fig1_task_graph.pdf | Introduction | Task formalization | Schematic | Project docs | Yes | Redraw as compact heterogeneous-graph diagram |
| fig2_dataset_sparsity.pdf | Dataset | Sparse long-tail graph | 2x2 CCDF/bar | Official edge files | Yes | Recompute degrees from real data |
| fig3_performance_evolution.pdf | Results | Stage-wise improvement | Line plot | Recorded metrics | Yes | Use clean dual-line plot and only three annotations |
| fig4_method_pipeline.pdf | Method | Two-stage stacker | Architecture | Code/docs | Yes | Aligned three-column schematic |
| fig5_highorder_ablation.pdf | Ablation | High-order citation lift | Two-panel line plot | validation_summary.csv | Yes | Separate F1 and AUC panels |
| fig6_calibration_rank_cutoff.pdf | Decision rule | Rank cutoff robustness | Line + grouped bars | ratio/threshold CSVs | Yes | Show ratio sweep and test drift |
| figA1_lightgcn_sweep.pdf | Appendix | LightGCN config | Heatmap | dynamic_summary.csv | No | Compact heatmap with NA cells |
| figA2_rw_ensemble.pdf | Appendix | RW ensemble benefit | Line plot | RW ablation CSVs | No | Small labels, no large annotations |
| figA3_feature_group_contribution.pdf | Appendix | Feature groups | Horizontal bars | Recorded metrics | No | Short labels and bounded x-axis |
| figA4_error_buckets.pdf | Appendix | Weak regimes | 1x3 heatmap | error buckets CSV | No | Split long heatmap into three panels |
| figA5_oof_pr_score.pdf | Appendix | OOF discrimination | PR + ECDF | OOF NPY files | No | Use ECDF instead of fragile density spike |
| figA6_feature_importance.pdf | Appendix optional | Feature importance | Bar chart | LightGBM model | Optional | Skip unless reliable feature names and LightGBM are available |

## Main-text figures

The main text should use Figures 1-6 only. These figures establish the task, data regime, method evolution, final pipeline, high-order ablation, and the rank-cutoff decision rule.

## Appendix figures

Appendix figures A1-A5 provide reproducibility and diagnostic support without crowding the main narrative. Figure A6 is skipped unless LightGBM model metadata can be loaded with reliable feature names.