@researai/deepscientist 1.5.16 → 1.6.0

package/src/skills/nature-figure/references/qa-contract.md

@@ -0,0 +1,119 @@
+# QA Contract
+
+Use this before final delivery, before a revision package, and whenever the figure
+contains microscopy, blots, gels, clinical subgroup analysis, or statistical claims.
+Journal rules change, so verify the latest target journal author guide for final
+submission. The values below are conservative defaults for Nature-family style work.
+
+## Current official references to verify
+
+- Nature research figure guide: `https://research-figure-guide.nature.com/`
+- Nature building/exporting panels: `https://research-figure-guide.nature.com/figures/building-and-exporting-figure-panels/`
+- Nature preparing figures/specifications: `https://research-figure-guide.nature.com/figures/preparing-figures-our-specifications/`
+- Nature initial submission and statistics guidance: `https://www.nature.com/nature/for-authors/initial-submission`
+- Nature formatting guide: `https://www.nature.com/nature/for-authors/formatting-guide`
+- Journal of Cell Biology figure/video guidelines for microscopy-oriented image QA: `https://rupress.org/jcb/pages/fig-vid-guidelines`
+- Elsevier/Cell-family image-manipulation baseline: `https://www.sciencedirect.com/journal/the-cell-surface/publish/guide-for-authors`
+
+## Pre-submission checklist
+
+| Check | Pass condition |
+|---|---|
+| Core conclusion | One-sentence claim exists and every panel maps to it |
+| Archetype | Figure has a declared archetype and panel hierarchy |
+| Backend exclusivity | The selected backend produced all plotting, previews, exports, and visual QA renders |
+| Final size | Single-column about 89 mm or double-column about 183 mm, height not above target journal limit |
+| Text size | Body/tick/legend text is readable at final size, usually 5-7 pt for dense journal figures |
+| Panel labels | Lowercase, bold, near top-left, typically 8 pt at final size |
+| Editable text | SVG/PDF text remains editable; no outlined text unless unavoidable for special symbols |
+| Font | Arial/Helvetica/sans-serif fallback is used consistently |
+| Color | No rainbow color maps; red/green is not the only encoding; grayscale print remains interpretable |
+| Legend strategy | Shared or direct labels where possible; no repeated redundant legends |
+| Statistics | `n`, biological/technical repeat definition, center, spread, test, correction, and exact comparison are documented |
+| Source data | Quantitative panels can be traced to a clean CSV/TSV/XLSX or script output |
+| Raster resolution | Photos/microscopy are high-resolution enough for final size; line art uses vector where possible |
+| Microscopy scale | Scale bar is present, calibrated, and not only a magnification factor |
+| Image integrity | Crop, contrast, pseudo-color, stitching, reuse, and raw-file provenance are recorded |
+| Export bundle | Script, source data, SVG, PDF, TIFF/PNG preview, and QA notes are delivered together when requested |
+
+## Statistics legend minimum
+
+For each quantitative panel, capture:
+
+```text
+n definition:
+biological replicates:
+technical replicates:
+center statistic:
+spread/interval:
+test:
+multiple-comparison correction:
+p-value display:
+source-data file:
+```
+
+For machine-learning/model figures, also capture:
+
+```text
+train/validation/test split:
+number of seeds or folds:
+metric definition:
+confidence interval or variability definition:
+baseline definition:
+```
+
+## Image-integrity minimum
+
+For each image panel, capture:
+
+```text
+raw file:
+processed file:
+crop:
+brightness/contrast/gamma:
+pseudo-color:
+scale calibration:
+stitching:
+reuse in other figures:
+quantification link:
+```
+
+Global adjustments are generally safer than local selective edits. If an adjustment
+changes the visibility of relevant background or bands, flag it instead of silently
+normalizing it away.
+
+## Export checks
+
+Run only the export block for the selected backend. If that backend is unavailable,
+stop and report the missing runtime/package instead of producing a substitute export
+with the other language.
+
+### Python
+
+```python
+import matplotlib as mpl
+mpl.rcParams["svg.fonttype"] = "none"
+mpl.rcParams["pdf.fonttype"] = 42
+fig.savefig("figure.svg", bbox_inches="tight")
+fig.savefig("figure.pdf", bbox_inches="tight")
+fig.savefig("figure.tiff", dpi=600, bbox_inches="tight")
+```
+
+### R
+
+```r
+svglite::svglite("figure.svg", width = width_mm / 25.4, height = height_mm / 25.4)
+print(plot)
+dev.off()
+
+grDevices::cairo_pdf("figure.pdf", width = width_mm / 25.4, height = height_mm / 25.4, family = "Arial")
+print(plot)
+dev.off()
+
+ragg::agg_tiff("figure.tiff", width = width_mm / 25.4, height = height_mm / 25.4, units = "in", res = 600)
+print(plot)
+dev.off()
+```
+
+Open the SVG/PDF after export and verify that text can be selected, labels do not
+overlap, and the figure still reads at final printed size.

package/src/skills/nature-figure/references/r-template-index.md

@@ -0,0 +1,66 @@
+# Private R Template Adaptation
+
+Use this reference when the user chooses R and provides or mentions an existing
+R plotting template collection. Treat such material as private working context.
+Do not reveal absolute paths, folder names, filenames, screenshots, provenance, or
+any identifying labels from the source collection in user-facing output.
+
+## Privacy rules
+
+- Never include absolute local paths in generated code, reports, comments, or final replies.
+- Never mention the original source file, folder, template number, course title, download
+  location, chat attachment, or private document name.
+- When a template is useful, describe it generically by chart family: "a grouped bar
+  template", "a ComplexHeatmap workflow", "a survival plotting workflow".
+- If a reusable idea is copied from a private template, rewrite the final code as a clean,
+  self-contained script with neutral function names and neutral comments.
+- If the user asks where a style came from, say it was adapted from the provided working
+  materials without identifying the path or source file.
+
+## Generic search strategy
+
+Search private materials by chart family and package names, not by exposing paths:
+
+```bash
+find <private-template-root> -type f \( -name '*.R' -o -name '*.Rmd' -o -name '*.r' \)
+rg -n "ggplot|patchwork|ComplexHeatmap|ggrepel|svglite|cairo_pdf|survminer|circlize" <private-template-root>
+```
+
+Keep these commands in internal working notes only. Do not paste the user's private
+root path into the final answer.
+
+## Chart-family map
+
+Use these generic families to decide what to inspect:
+
+| Need | Search targets |
+|---|---|
+| Bars and grouped comparisons | `geom_col`, `geom_bar`, `position_dodge`, `stat_compare_means` |
+| Error bars and point-interval plots | `geom_errorbar`, `geom_pointrange`, `mean_se`, `stat_summary` |
+| Stacked or bidirectional bars | `position_stack`, `coord_flip`, signed values, paired positive/negative bars |
+| Box, violin, paired, and raincloud-style distributions | `geom_boxplot`, `geom_violin`, `geom_jitter`, paired sample identifiers |
+| Heatmaps and annotated heatmaps | `ComplexHeatmap`, `HeatmapAnnotation`, `pheatmap`, `geom_tile` |
+| Correlation, scatter, bubble, and volcano plots | `geom_point`, `geom_smooth`, `ggrepel`, `logFC`, `pvalue`, bubble size scales |
+| PCA, PCoA, NMDS, tSNE, UMAP | `prcomp`, `cmdscale`, `vegan`, `Rtsne`, `Seurat`, embedding coordinates |
+| Survival, Cox, subgroup, ROC, forest | `survival`, `survminer`, `coxph`, `forestplot`, `timeROC`, hazard ratios |
+| Enrichment and pathway summaries | `clusterProfiler`, `GSEA`, `enrichGO`, `enrichKEGG`, dot plots, ridge plots |
+| Circular, genome, phylogeny, chromosome | `circlize`, `ggtree`, `karyoploteR`, genome interval tracks |
+| Single-cell and omics workflows | `Seurat`, marker genes, differential expression, cell-type annotation |
+| Maps, anatomy, and spatial summaries | `sf`, `maps`, `gganatogram`, spatial coordinates |
+| Radar, lollipop, dumbbell, UpSet, Venn, Sankey | `ggradar`, `geom_segment`, `UpSetR`, `ggalluvial`, set operations |
+
+## Adaptation checklist
+
+When adapting a private template:
+
+- Keep useful data wrangling, statistics, and geoms.
+- Replace template-specific colors with the figure-level semantic palette.
+- Normalize fonts to final-size 5-7 pt text and 8 pt bold lowercase panel labels.
+- Convert single-output PNG/PDF scripts to SVG/PDF/TIFF export.
+- Remove decorative elements that do not support the core conclusion.
+- Ensure each statistical comparison has `n`, center, spread, test, and correction
+  information in the legend or source-data notes.
+- For image panels, document raw file, crop, contrast, scale-bar calibration, and any
+  stitching or pseudo-coloring in private QA notes.
+- Final code should be self-contained and should not require the original private
+  folder structure unless the user explicitly asks to keep that workflow.

package/src/skills/nature-figure/references/r-workflow.md

@@ -0,0 +1,161 @@
+# R Workflow
+
+Use this when the user chooses R, brings R data/scripts, or asks to reuse the local
+R plotting templates. The R track should still follow the same figure contract:
+claim first, evidence hierarchy second, plotting code third.
+
+## R-only execution rule
+
+When the user has selected R, do all figure drawing, previewing, exporting, and
+visual QA in R. Do not call Python/matplotlib/seaborn/plotly to create a temporary
+preview, fallback export, or layout approximation. If R, `Rscript`, or required R
+packages are missing, stop before rendering and report the missing dependency. You
+may still write the R script, provide `install.packages()` commands, or ask permission
+to install dependencies, but do not cross-render the figure in another language.
+
+Allowed non-R utilities are limited to non-visual tasks such as shell file inspection,
+CSV line counts, checksums, archive extraction, or text search. They must not create
+image/vector outputs or alter visual layout.
+
+## Required packages by task
+
+| Task | Preferred packages |
+|---|---|
+| Bars, boxplots, violins, dot plots, lines, volcano plots | `ggplot2`, `ggrepel`, `dplyr`, `tidyr` |
+| Multi-panel assembly | `patchwork`; use `cowplot` only when inset alignment requires it |
+| Rich omics heatmaps | `ComplexHeatmap`, `circlize`, `grid` |
+| Survival and clinical subgroup plots | `survival`, `survminer`, `forestplot`, `ggplot2` |
+| Circular/genome plots | `circlize`, `ggtree`, `gggenes`, domain-specific packages |
+| Export | `svglite`, `grDevices::cairo_pdf`, `ragg` |
+
+## Contract scaffold
+
+```r
+library(ggplot2)
+library(patchwork)
+
+palette_contract <- c(
+  neutral_dark = "#272727",
+  neutral_mid = "#767676",
+  neutral_light = "#D8D8D8",
+  signal_blue = "#3182BD",
+  signal_teal = "#33B5A5",
+  accent_red = "#D24B40",
+  accent_orange = "#E28E2C"
+)
+
+theme_nature_contract <- function(base_size = 6.5, base_family = "Arial") {
+  theme_classic(base_size = base_size, base_family = base_family) +
+    theme(
+      axis.line = element_line(linewidth = 0.35, colour = "black"),
+      axis.ticks = element_line(linewidth = 0.35, colour = "black"),
+      axis.title = element_text(size = base_size),
+      axis.text = element_text(size = base_size - 0.5),
+      legend.title = element_text(size = base_size - 0.3),
+      legend.text = element_text(size = base_size - 0.7),
+      strip.text = element_text(size = base_size - 0.3, face = "bold"),
+      plot.title = element_text(size = base_size + 0.5, face = "bold"),
+      panel.grid = element_blank()
+    )
+}
+
+theme_set(theme_nature_contract())
+
+save_pub_r <- function(plot, filename, width_mm = 183, height_mm = 120, dpi = 600) {
+  w <- width_mm / 25.4
+  h <- height_mm / 25.4
+
+  svglite::svglite(paste0(filename, ".svg"), width = w, height = h)
+  print(plot)
+  dev.off()
+
+  grDevices::cairo_pdf(paste0(filename, ".pdf"), width = w, height = h, family = "Arial")
+  print(plot)
+  dev.off()
+
+  ragg::agg_tiff(paste0(filename, ".tiff"), width = w, height = h, units = "in", res = dpi)
+  print(plot)
+  dev.off()
+}
+```
+
+## Panel labels in R
+
+Use patchwork tags for most multi-panel figures:
+
+```r
+fig <- (p_a | p_b) / (p_c | p_d) +
+  plot_annotation(tag_levels = "a") &
+  theme(plot.tag = element_text(size = 8, face = "bold"))
+```
+
+Use manual labels only when dark image plates or inset geometry make patchwork tags
+misalign.
+
+## Patchwork layout patterns
+
+### Quantitative grid
+
+```r
+fig <- (p_a | p_b | guide_area()) /
+       (p_c | p_d | p_e) +
+  plot_layout(guides = "collect", widths = c(1, 1, 0.45)) &
+  theme(legend.position = "right")
+```
+
+### Schematic-led composite
+
+```r
+design <- "
+AAAA
+BBCD
+"
+fig <- p_schematic + p_b + p_c + p_d +
+  plot_layout(design = design, heights = c(1.8, 1))
+```
+
+### Image plate plus quant
+
+Keep black backgrounds inside image panels only. Put scale bars on the image, then
+place quantification next to or below the representative image.
+
+```r
+p_img <- ggplot(img_df, aes(x, y, fill = intensity)) +
+  geom_raster() +
+  scale_fill_gradient(low = "black", high = "white") +
+  coord_fixed(expand = FALSE) +
+  annotate("segment", x = 10, xend = 40, y = 10, yend = 10,
+           linewidth = 0.6, colour = "white") +
+  theme_void() +
+  theme(legend.position = "none", plot.background = element_rect(fill = "black", colour = NA))
+```
+
+## ComplexHeatmap export
+
+`ComplexHeatmap` objects are grid objects, not ggplot objects. Export them by opening
+the graphics device, drawing, then closing it.
+
+```r
+library(ComplexHeatmap)
+library(circlize)
+
+pdf("heatmap.pdf", width = 7.2, height = 4.8, family = "Arial")
+draw(ht, heatmap_legend_side = "right", annotation_legend_side = "right")
+dev.off()
+
+svglite::svglite("heatmap.svg", width = 7.2, height = 4.8)
+draw(ht, heatmap_legend_side = "right", annotation_legend_side = "right")
+dev.off()
+```
+
+## Template reuse rule
+
+The local R materials are examples, not final style. When reusing them:
+
+1. Inspect only the nearest template folder.
+2. Keep useful data wrangling, statistics, and geoms.
+3. Replace ad hoc colors, oversized fonts, dense legends, and PNG-only export.
+4. Rebuild the final script around `theme_nature_contract()` and `save_pub_r()`.
+5. Add source-data output if the figure is manuscript-facing.
+
+Open `references/r-template-index.md` for the local template atlas.

package/src/skills/nature-figure/references/tutorials.md

@@ -0,0 +1,250 @@
+# Tutorials — Nature Figure Making
+
+End-to-end walkthroughs for the most common publication figure types.
+All examples use helpers from [api.md](api.md) and patterns from [common-patterns.md](common-patterns.md).
+
+---
+
+## Tutorial 1: Grouped bar chart (multi-metric comparison)
+
+**Goal**: Several methods compared across multiple metrics. Legend in a dedicated panel.
+When methods belong to related families, use one coherent baseline family plus one coherent hero family.
+
+```python
+import os
+import numpy as np
+import matplotlib.pyplot as plt
+from matplotlib import gridspec
+
+# --- Style ---
+plt.rcParams['font.family'] = 'sans-serif'
+plt.rcParams['font.sans-serif'] = ['Arial']
+plt.rcParams['svg.fonttype'] = 'none'
+plt.rcParams['font.size'] = 24
+plt.rcParams['axes.spines.right'] = False
+plt.rcParams['axes.spines.top'] = False
+plt.rcParams['axes.linewidth'] = 3
+
+# --- Data ---
+methods = ['ResNet1d18', 'ResNet1d34', 'ECGFounder', 'CSFM-Tiny', 'CSFM-Base', 'CSFM-Large']
+colors  = ['#484878', '#7884B4', '#B4C0E4', '#E4E4F0', '#E4CCD8', '#F0C0CC']
+metrics = ['Metric 1', 'Metric 2', 'Metric 3']
+mean = {
+    'Metric 1': np.array([0.81, 0.83, 0.86, 0.89, 0.91, 0.92]),
+    'Metric 2': np.array([0.63, 0.67, 0.71, 0.74, 0.77, 0.79]),
+    'Metric 3': np.array([0.41, 0.45, 0.49, 0.53, 0.56, 0.58]),
+}
+std  = {k: v * 0.03 for k, v in mean.items()}  # placeholder
+
+# --- Figure ---
+fig = plt.figure(figsize=(28, 6))
+gs = gridspec.GridSpec(1, len(metrics) + 1)  # +1 for legend panel
+
+handles, labels = None, None
+for col, metric in enumerate(metrics):
+    ax = fig.add_subplot(gs[col])
+    bars = ax.bar(
+        range(len(methods)),
+        mean[metric],
+        yerr=std[metric],
+        capsize=5,
+        color=colors,
+        label=methods,
+        error_kw={'elinewidth': 2, 'capthick': 2},
+    )
+    if col == 0:
+        handles, labels = ax.get_legend_handles_labels()
+    ax.set_xticks([])
+    y_vals = mean[metric]
+    margin = (y_vals.max() - y_vals.min()) * 0.15
+    ax.set_ylim([y_vals.min() - margin, y_vals.max() + margin])
+    ax.set_ylabel(metric, fontsize=32)
+
+# Legend-only panel
+ax_leg = fig.add_subplot(gs[-1])
+ax_leg.legend(handles, labels, fontsize=28, loc='center', frameon=False)
+ax_leg.set_axis_off()
+
+fig.tight_layout(pad=2)
+os.makedirs('./figures', exist_ok=True)
+fig.savefig('./figures/comparison.png', dpi=300)
+fig.savefig('./figures/comparison.pdf', dpi=300)
+plt.close(fig)
+```
+
+---
+
+## Tutorial 2: Ablation bar chart (alpha-graduated, horizontal)
+
+**Goal**: Same method with components progressively added; alpha encodes completeness.
+
+```python
+import os
+import numpy as np
+import matplotlib.pyplot as plt
+
+plt.rcParams['font.family'] = 'sans-serif'
+plt.rcParams['font.sans-serif'] = ['Arial']
+plt.rcParams['svg.fonttype'] = 'none'
+plt.rcParams['font.size'] = 24
+plt.rcParams['axes.spines.right'] = False
+plt.rcParams['axes.spines.top'] = False
+plt.rcParams['axes.linewidth'] = 3
+
+configs = ['None', '+ Module A', '+ Module B', '+ Module C', 'Full']
+values  = np.array([0.72, 0.78, 0.81, 0.84, 0.88])
+stds    = np.array([0.02, 0.02, 0.01, 0.01, 0.01])
+
+n = len(configs)
+blue_rgb = (0.215686, 0.458824, 0.729412)   # #3775BA
+alphas = np.linspace(0.2, 1.0, n)
+colors = [(blue_rgb[0], blue_rgb[1], blue_rgb[2], a) for a in alphas]
+
+fig, ax = plt.subplots(figsize=(12, 6))
+ax.barh(range(n), values, xerr=stds,
+        color=colors, ecolor='k', capsize=5)
+ax.set_yticks(range(n))
+ax.set_yticklabels(configs)
+ax.set_xlim([values.min() - 0.05, values.max() + 0.03])
+ax.set_xlabel('Score', fontsize=32)
+
+fig.tight_layout(pad=2)
+os.makedirs('./figures', exist_ok=True)
+fig.savefig('./figures/ablation.png', dpi=300)
+plt.close(fig)
+```
+
+---
+
+## Tutorial 3: Multi-panel trend with shared legend
+
+**Goal**: Two trend panels (e.g., train/val curves) and a legend-only third panel.
+
+```python
+import os
+import numpy as np
+import matplotlib.pyplot as plt
+
+plt.rcParams['font.family'] = 'sans-serif'
+plt.rcParams['font.sans-serif'] = ['Arial']
+plt.rcParams['svg.fonttype'] = 'none'
+plt.rcParams['font.size'] = 15
+plt.rcParams['axes.spines.right'] = False
+plt.rcParams['axes.spines.top'] = False
+plt.rcParams['axes.linewidth'] = 2
+
+methods = ['Baseline', 'CSFM-Tiny', 'CSFM-Base', 'CSFM-Large']
+colors  = ['#7884B4', '#E4E4F0', '#E4CCD8', '#F0C0CC']
+x = np.arange(0, 100, 5)
+
+fig, axes = plt.subplots(1, 3, figsize=(18, 5))
+
+for panel_idx, (ax, panel_name) in enumerate(zip(axes[:2], ['Training', 'Validation'])):
+    for method, color in zip(methods, colors):
+        y = 0.48 + 0.42 * (1 - np.exp(-x / 30)) + np.random.randn(len(x)) * 0.01
+        if method == 'Baseline':
+            y -= 0.03
+        elif method == 'CSFM-Tiny':
+            y += 0.00
+        elif method == 'CSFM-Base':
+            y += 0.02
+        elif method == 'CSFM-Large':
+            y += 0.03
+        ax.plot(x, y, color=color, lw=2.5, marker='o', markersize=6, label=method)
+    ax.set_title(panel_name, fontsize=18)
+    ax.set_xlabel('Epoch', fontsize=16)
+    ax.set_ylabel('Loss', fontsize=16)
+    if panel_idx == 0:
+        handles, labels = ax.get_legend_handles_labels()
+
+# Legend-only panel
+axes[2].legend(handles, labels, fontsize=14, loc='center', frameon=False)
+axes[2].set_axis_off()
+
+fig.tight_layout(pad=2)
+os.makedirs('./figures', exist_ok=True)
+fig.savefig('./figures/trends.png', dpi=300)
+fig.savefig('./figures/trends.pdf', dpi=300)
+plt.close(fig)
+```
+
+---
+
+## Tutorial 4: Heatmap with dual colormaps (positive/negative columns)
+
+**Goal**: Score matrix where positive = Reds, negative = Blues_r. Cell text auto-contrasted.
+
+```python
+import os
+import numpy as np
+import matplotlib as mpl
+import matplotlib.pyplot as plt
+
+plt.rcParams['font.family'] = 'sans-serif'
+plt.rcParams['font.sans-serif'] = ['Arial']
+plt.rcParams['svg.fonttype'] = 'none'
+plt.rcParams['font.size'] = 16
+plt.rcParams['axes.spines.right'] = False
+plt.rcParams['axes.spines.top'] = False
+plt.rcParams['axes.linewidth'] = 2
+
+# matrix: rows = methods, cols = metrics (alternating positive/negative directions)
+methods = ['Method A', 'Method B', 'Method C', 'Method D']
+metrics = ['Score (+)', 'Error (-)', 'F1 (+)', 'Loss (-)']
+matrix  = np.array([
+    [0.88,  0.12,  0.85,  0.20],
+    [0.81,  0.18,  0.78,  0.28],
+    [0.75,  0.25,  0.72,  0.35],
+    [0.70,  0.30,  0.68,  0.40],
+])
+
+fig, ax = plt.subplots(figsize=(10, 6))
+n_rows, n_cols = matrix.shape
+vmin, vmax = matrix.min(0), matrix.max(0)
+
+for j in range(n_cols):
+    is_positive = (j % 2 == 0)
+    cmap = plt.cm.Reds if is_positive else plt.cm.Blues_r
+    cmap = cmap.copy()
+    norm = mpl.colors.Normalize(
+        vmin=0 if is_positive else vmax[j],
+        vmax=vmax[j] if is_positive else 0
+    )
+    ax.imshow(matrix[:, j:j+1], cmap=cmap, norm=norm,
+              aspect='auto', extent=[j-0.5, j+0.5, 0, n_rows], origin='lower')
+
+for (i, j), val in np.ndenumerate(matrix):
+    is_positive = (j % 2 == 0)
+    cmap = plt.cm.Reds if is_positive else plt.cm.Blues_r
+    norm = mpl.colors.Normalize(vmin=0 if is_positive else vmax[j],
+                                 vmax=vmax[j] if is_positive else 0)
+    r, g, b, _ = cmap(norm(val))
+    lum = 0.299*r + 0.587*g + 0.114*b
+    color = 'white' if lum < 0.5 else 'black'
+    ax.text(j, i + 0.5, f'{val:.2f}', ha='center', va='center',
+            fontsize=13, color=color)
+
+ax.set_xlim(-0.5, n_cols - 0.5)
+ax.set_xticks(np.arange(n_cols))
+ax.set_xticklabels(metrics, rotation=30, ha='right', fontsize=14)
+ax.tick_params(axis='x', bottom=False, top=False, length=0)
+ax.set_yticks(np.arange(n_rows) + 0.5)
+ax.set_yticklabels(methods, fontsize=14)
+ax.set_frame_on(False)
+ax.invert_yaxis()
+
+fig.tight_layout(pad=2)
+os.makedirs('./figures', exist_ok=True)
+fig.savefig('./figures/heatmap.png', dpi=300)
+plt.close(fig)
+```
+
+---
+
+## Related files
+
+- [SKILL.md](../SKILL.md) — When to use this skill
+- [api.md](api.md) — Reusable helper implementations
+- [common-patterns.md](common-patterns.md) — Layout and encoding patterns used above
+- [design-theory.md](design-theory.md) — Why these choices exist
+- [chart-types.md](chart-types.md) — Radar, 3D sphere, scatter, fill_between