OrinVoss/dsh-math-team / presets/model-code/skills/math-model-code/references/可视化规范
科研可视化工具
Verified从数据剖析到出版级成图的完整可视化工具。先做数据剖析(列类型/样本量/分布/异常值/分组结构/相关性), 再结合论证目标推荐图型,主动拦截科研画图经典错误,产出 Nature / Science / IEEE / Elsevier / PNAS / 中文核心期刊级别的成图。覆盖数据 EDA、图表契约、选图决策、出版级绘制、程序自检 + AI 读图闭环、多格式 导出和文件审计。数学建模场景额外支持三类图体系(原始数据/过程/结果)和子问题覆盖检查。 当用户涉及论文配图、科研画图、数据可视化、选图、期刊投稿图、figure、出版级图表、matplotlib、seaborn、 plotly、误差棒、显著性标注、色盲安全配色、矢量图导出、中文论文图表、多面板时使用。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.8 KB |
| chart-types/chart_selection.md | markdown | 15.2 KB |
| chart-types/chart_types.md | markdown | 6.8 KB |
| design/common_patterns.md | markdown | 7.9 KB |
| design/design_theory.md | markdown | 15.5 KB |
| design/viz_pitfalls.md | markdown | 16.7 KB |
| quality/journal_specs.md | markdown | 7.3 KB |
| quality/publication_checklist.md | markdown | 6.1 KB |
| quality/qa_contract.md | markdown | 3.0 KB |
| quality/visual_review.md | markdown | 7.2 KB |
| static/core/contract.md | markdown | 4.3 KB |
static/core/contract.md
View on GitHub> **⚠️ 工具脚本未随附**:本文档提及的绘图脚本(如 `setup_style.py`、`export_figure.py`、`visual_qa.py`、`apply_publication_style.m` 等)来自参考仓库的**工具脚本**,本预设**仅随附方法论文档,未包含这些脚本**。遇到此类脚本时按正文描述的方法自行实现等价脚本,或由团队另行接入;**不要假设它们存在于本机**。方法规范本身仍然有效。
# Figure contract before plotting
A publication-quality scientific figure is a visual argument, not an isolated pretty plot. Every figure starts from a claim, an evidence hierarchy, and a review-risk check before code or aesthetics. Before generating or editing code, establish the contract below.
## Backend selection follows the modeling language
This skill supports **Python** and **MATLAB** as plotting backends. The backend is determined by the modeling language already chosen in the pipeline (编程手 selects Python or MATLAB in step 1). Do not ask the user to choose a plotting language separately—reuse the modeling language already in use for that question.
- If the task uses Python for modeling, plot with the Python toolchain (`setup_style.py`, `export_figure.py`, `visual_qa.py`).
- If the task uses MATLAB for modeling, plot with the MATLAB toolchain (`apply_publication_style.m`, `export_publication_figure.m`).
There is no R backend in this skill. Any reference to R, `nature_figure_backend.py set r`, or `backend-selection.md` in upstream documents is obsolete and must be ignored.
## The selected backend is exclusive
Once Python or MATLAB is selected, every plotting script, preview image, SVG/PDF/PNG export, QA render, and visual workaround must be produced by that same backend. Do not use Python to draw a preview for a MATLAB figure, and do not use MATLAB to draw a preview for a Python figure, even if the selected runtime or packages are missing locally. The non-selected language may only be used for non-visual file inspection or data conversion when it does not open a graphics device, import plotting libraries, create image/vector files, or change the final visual appearance.
## Missing runtime/package rule
After the backend is selected, check the selected runtime early (MATLAB toolboxes for MATLAB; Python and required plotting packages for Python). If the selected runtime or required packages are unavailable, stop before rendering and report the exact blocker. You may provide a selected-backend script and installation commands, or ask permission to install dependencies, but you must not fall back to the other language to make a substitute figure.
## Data-integrity gate
Use all user-provided observations and requested variables unless an exclusion has a scientific or statistical justification or the user explicitly requests a subset. Never reduce data merely to make a plot easier or faster to render. For large point clouds, prefer rasterized marks, hexbin/density representations, aggregation with a stated rule, or another backend-native rendering strategy.
If any row, column, replicate, image, or category is excluded, record the before/after counts, the exact rule, and the reason in the QA notes. Preserve the unmodified source data and never silently select convenient columns to satisfy a template.
## The five-point contract
1. **Core conclusion**: write the one-sentence claim the figure must defend.
2. **Evidence chain**: map each planned panel to the claim, and drop panels that do not carry a unique piece of evidence.
3. **Archetype**: classify the figure as `quantitative grid`, `schematic-led composite`, `image plate + quant`, or `asymmetric mixed-modality figure`.
4. **Backend**: use the explicit Python/MATLAB track exclusively for all figure drawing, previewing, exporting, and visual QA. Do not cross-render with the other language.
5. **Journal/export contract**: set final dimensions, editable text, source data, statistics, image-integrity notes, and export formats before styling.
The highest-priority rule is: **the chart serves the scientific logic**. Aesthetic polish, template matching, and complex layout are subordinate to making the core conclusion clear, defensible, and reviewable.
For the full method to convert a request into core conclusion, evidence hierarchy, panel map, and review-risk checks, open `references/figure-contract.md`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |