XiaoMaColtAI/math-modeling-skill / tools/figure
科研可视化工具
Verified从数据剖析到出版级成图的完整可视化工具。先做数据剖析(列类型/样本量/分布/异常值/分组结构/相关性), 再结合论证目标推荐图型,主动拦截科研画图经典错误,产出 Nature / Science / IEEE / Elsevier / PNAS / 中文核心期刊级别的成图。覆盖数据 EDA、图表契约、选图决策、出版级绘制、程序自检 + AI 读图闭环、多格式 导出和文件审计。数学建模场景额外支持三类图体系(原始数据/过程/结果)、子问题覆盖检查和建模流程图规范。 当用户涉及论文配图、科研画图、数据可视化、选图、期刊投稿图、figure、出版级图表、matplotlib、seaborn、 plotly、误差棒、显著性标注、色盲安全配色、矢量图导出、中文论文图表、多面板时使用。
scripts/export_figure.py
View on GitHub"""
scipilot-figure-skill :: export_figure.py
=========================================
Unified figure export to multiple formats at exact final size.
- Vector preferred: PDF / SVG / EPS for line/bar/scatter (lossless, journal-friendly).
- Raster for photos / micrographs: PNG / TIFF at >= 300 DPI; never JPEG for data figures.
- Embeds TrueType fonts (fonttype 42) so journals don't reject Type-3 PDFs.
- Optional grayscale preview to sanity-check colorblind safety.
Usage
-----
from export_figure import export_figure
import matplotlib.pyplot as plt
fig, ax = plt.subplots()
ax.plot([0,1,2],[3,1,4])
paths = export_figure(
fig,
basename="figs/fig1_main",
formats=["pdf", "svg", "png"],
size_inches=(3.5, 2.625), # 强制成 Nature 单栏尺寸
dpi=600,
grayscale_preview=True,
)
# -> ['figs/fig1_main.pdf', 'figs/fig1_main.svg',
# 'figs/fig1_main.png', 'figs/fig1_main_grayscale.png']
CLI: ``python export_figure.py demo`` 生成一张演示图并多格式导出。
"""
from __future__ import annotations
import argparse
import os
import sys
from typing import Iterable
import matplotlib.pyplot as plt
VECTOR_FORMATS = {"pdf", "svg", "eps"}
RASTER_FORMATS = {"png", "tiff", "tif", "jpg", "jpeg"}
SUPPORTED_FORMATS = VECTOR_FORMATS | RASTER_FORMATS
def _ensure_parent(path: str) -> None:
parent = os.path.dirname(os.path.abspath(path))
if parent and not os.path.exists(parent):
os.makedirs(parent, exist_ok=True)
def export_figure(
fig,
basename: str,
formats: Iterable[str] | None = None,
dpi: int = 300,
size_inches: tuple[float, float] | None = None,
grayscale_preview: bool = False,
tight: bool = True,
pad_inches: float = 0.05,
transparent: bool = False,
) -> list[str]:
"""
Export a matplotlib Figure to one or more formats at exact final size.
Args:
fig: matplotlib Figure object.
basename: 输出路径前缀(不含扩展名);可包含子目录,自动创建。
formats: list/tuple of extensions, e.g. ['pdf', 'svg', 'png'].
Default: ['pdf', 'svg', 'png'].
dpi: raster 格式分辨率;建议 300(普通)/ 600(IEEE 等)。
size_inches: (width, height) 英寸;指定后会 fig.set_size_inches() 强制
最终尺寸。强烈建议传入——保证导出后不必在 Word/LaTeX 里二次缩放。
grayscale_preview: 额外生成一张 _grayscale.png 供色盲安全检查。
tight: 是否走 bbox_inches='tight'(裁掉留白)。
pad_inches: tight 模式下保留的边距(英寸)。
transparent: 透明背景(PPT/海报可能需要)。
Returns:
实际写出的文件路径列表。
"""
if formats is None:
formats = ("pdf", "svg", "png")
formats = [f.lower().lstrip(".") for f in formats]
unknown = [f for f in formats if f not in SUPPORTED_FORMATS]
if unknown:
raise ValueError(f"Unsupported formats: {unknown}. "
f"Supported: {sorted(SUPPORTED_FORMATS)}")
if size_inches is not None:
if len(size_inches) != 2:
raise ValueError("size_inches must be (width, height)")
fig.set_size_inches(*size_inches)
# 强制嵌入 TrueType 字体(fonttype 42);多家期刊明确拒绝 Type-3 PDF。
plt.rcParams["pdf.fonttype"] = 42
plt.rcParams["ps.fonttype"] = 42
plt.rcParams["svg.fonttype"] = "none" # 文本仍可编辑,期刊通常更欢迎
saved: list[str] = []
for fmt in formats:
if fmt in {"jpg", "jpeg"}:
print(f"[scipilot-figure-skill] WARNING: skipping {fmt} — "
"JPEG is lossy and unsuitable for line/text figures.",
file=sys.stderr)
continue
path = f"{basename}.{fmt}"
_ensure_parent(path)
kwargs: dict = {
"bbox_inches": "tight" if tight else None,
"pad_inches": pad_inches,
"transparent": transparent,
}
if fmt in RASTER_FORMATS:
kwargs["dpi"] = dpi
fig.savefig(path, **kwargs)
saved.append(path)
print(f"[scipilot-figure-skill] wrote {path}")
if grayscale_preview:
gray_path = _grayscale_from(fig, basename, dpi=dpi)
if gray_path:
saved.append(gray_path)
return saved
def _grayscale_from(fig, basename: str, dpi: int) -> str | None:
"""
导出灰度预览版用于色盲安全检查。
优先用 PIL 转灰度;找不到 PIL 时退化为重新画图(关闭颜色)。
"""
try:
from PIL import Image
except ImportError:
print("[scipilot-figure-skill] Pillow not available; "
"grayscale preview skipped.", file=sys.stderr)
return None
png_path = f"{basename}.png"
_ensure_parent(png_path)
fig.savefig(png_path, dpi=dpi, bbox_inches="tight")
gray_path = f"{basename}_grayscale.png"
Image.open(png_path).convert("L").save(gray_path)
print(f"[scipilot-figure-skill] wrote {gray_path} (grayscale preview)")
return gray_path
def _demo(out_basename: str) -> None:
"""Generate a small demo figure for quick smoke testing."""
import numpy as np
rng = np.random.default_rng(7)
x = np.linspace(0, 10, 50)
y1 = np.sin(x) + rng.normal(0, 0.1, x.size)
y2 = np.cos(x) + rng.normal(0, 0.1, x.size)
fig, ax = plt.subplots(figsize=(3.5, 2.625))
ax.plot(x, y1, label="sin", marker="o", markersize=3)
ax.plot(x, y2, label="cos", marker="s", markersize=3, linestyle="--")
ax.set_xlabel("x")
ax.set_ylabel("y")
ax.legend(frameon=False)
paths = export_figure(
fig, out_basename,
formats=["pdf", "svg", "png"],
size_inches=(3.5, 2.625),
dpi=300,
grayscale_preview=True,
)
print("\nDemo done. Files:")
for p in paths:
print(f" {p}")
def _cli() -> int:
p = argparse.ArgumentParser(description="scipilot-figure-skill figure exporter")
p.add_argument("cmd", choices=["demo"], help="`demo`: 跑一张演示图导出 4 种格式")
p.add_argument("--out", default="./scipilot_demo",
help="输出 basename (默认 ./scipilot_demo)")
args = p.parse_args()
if args.cmd == "demo":
_demo(args.out)
return 0
if __name__ == "__main__":
sys.exit(_cli())
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 |