vr-make-figures

name	vr-make-figures
description	Analyzes experiment results and generates publication-quality figures for papers using matplotlib.
user-invocable	true
argument-hint	["experiment-directory"]

Make Figures

Analyzes experiment results and generates publication-quality figures.

Input

$ARGUMENTS - Experiment directory path (result files must exist under results/)

Process

Step 1: Load Result Data

• Load $ARGUMENTS/results/raw_results.json
• Load $ARGUMENTS/results/summary_stats.json
• Check experiment settings in $ARGUMENTS/config.yaml
• Check metric definitions in $ARGUMENTS/plan.md

Step 2: Data Analysis

• Performance comparison across conditions
• Statistical significance testing (t-test, ANOVA, etc.)
• Effect size calculation
• Outlier detection

Step 3: Figure Planning

Select appropriate visualization types for the experiment results:

• Bar chart: Comparison between conditions
• Line plot: Trends over time
• Box plot: Distribution comparison
• Heatmap: Multivariate comparison
• Scatter plot: Correlations
• Table: Detailed numerical comparison

Step 4: Write Figure Generation Code

Create $ARGUMENTS/analysis.py.

Figure style rules (see @scripts/plot_style.py):

• Font: Paper default (serif family, 10-12pt)
• Colors: Use colorblind-friendly palette
• Figure size: Single column (3.5in) or double column (7in)
• DPI: 300 or higher
• Clearly display axis labels and legends
• Remove unnecessary decorations (no chartjunk)
• Include error bars (standard deviation or confidence interval)

Step 5: Generate and Save Figures

python $ARGUMENTS/analysis.py

Output

File Structure

$ARGUMENTS/
├── results/
│   ├── raw_results.json
│   ├── summary_stats.json
│   └── statistical_tests.json   # Statistical test results
├── analysis.py                   # Analysis and visualization code
└── figures/
    ├── fig1_main_results.pdf     # Main results
    ├── fig1_main_results.png
    ├── fig2_*.pdf                # Additional figures
    ├── fig2_*.png
    ├── table1_results.tex        # LaTeX table
    └── figure_descriptions.md    # Captions/descriptions for each figure

figure_descriptions.md Format

# Figure Descriptions

## Figure 1: [Title]
- **File**: fig1_main_results.pdf
- **Type**: [bar chart / line plot / ...]
- **Description**: [What this figure shows]
- **Key Findings**: [Summary of key results]
- **Caption Draft**: [Caption for use in the paper]

## Table 1: [Title]
- **File**: table1_results.tex
- **Description**: [Contents of the table]
- **Caption Draft**: [Caption for use in the paper]

Notes

• Prioritize figure readability above all else
• Avoid unnecessary 3D effects or excessive use of colors
• All figures must be distinguishable even in black-and-white print
• After completing figures, proceed to paper writing with /vr-write-paper $ARGUMENTS