# Research Visuals Reference (PaperBanana Integration)

Use this subcategory for publication-style academic visuals.

## Research Visual Types

| Type | Description | Tool |
|------|-------------|------|
| `research-diagram` | Methodology/framework diagram from research text | `paperbanana generate` |
| `research-plot` | Statistical plot from CSV/JSON data | `paperbanana plot` |
| `research-evaluation` | Compare generated diagram vs reference | `paperbanana evaluate` |

## Prerequisites

- Python 3.10+
- `pip install paperbanana`
- `GOOGLE_API_KEY` configured (required for default Gemini pipeline)
- Optional: `paperbanana setup` for local config

## Required User Inputs (minimum questions)

### research-diagram (minimum required)
1. Source context text (methodology description)
2. Figure caption / communicative intent

Defaults (do not ask unless needed):
- Style: `clean academic`
- Iterations: `3`
- Output path: auto-generated

### research-plot (minimum required)
1. Data file path (`.csv` or `.json`)
2. Plot intent (what comparison/story the chart should convey)

Defaults (do not ask unless needed):
- Style constraints: none
- Iterations: `3`
- Output path: auto-generated

### research-evaluation (required)
1. Generated diagram path
2. Human reference diagram path
3. Source context text path
4. Figure caption / intent

## CLI Commands

```bash
# Generate methodology diagram
paperbanana generate --context "methodology text" --caption "Figure 1: System overview"

# Generate statistical plot
paperbanana plot --data data.csv --intent "Compare latency across regions"

# Evaluate diagram quality
paperbanana evaluate --generated gen.png --reference ref.png --context ctx.txt --caption "Fig 1"
```