XiaoMaColtAI/math-modeling-skill / tools/figure
科研可视化工具
Verified从数据剖析到出版级成图的完整可视化工具。先做数据剖析(列类型/样本量/分布/异常值/分组结构/相关性), 再结合论证目标推荐图型,主动拦截科研画图经典错误,产出 Nature / Science / IEEE / Elsevier / PNAS / 中文核心期刊级别的成图。覆盖数据 EDA、图表契约、选图决策、出版级绘制、程序自检 + AI 读图闭环、多格式 导出和文件审计。数学建模场景额外支持三类图体系(原始数据/过程/结果)、子问题覆盖检查和建模流程图规范。 当用户涉及论文配图、科研画图、数据可视化、选图、期刊投稿图、figure、出版级图表、matplotlib、seaborn、 plotly、误差棒、显著性标注、色盲安全配色、矢量图导出、中文论文图表、多面板时使用。
scripts/check_figure.py
View on GitHub"""
scipilot-figure-skill :: check_figure.py
========================================
Pre-submission figure compliance audit.
逐文件检查:格式(矢量 vs 位图 vs 不允许的 JPEG)、像素尺寸/DPI、
矢量 PDF 的字体嵌入类型(必须 TrueType/Type 42),输出问题清单。
非破坏性——只读、不修改原图。
Usage
-----
from check_figure import check_figure, print_report
issues, info = check_figure("figs/fig1.pdf", min_dpi=300, target_inches=(3.5, 2.625))
print_report("figs/fig1.pdf", issues, info)
CLI:
python check_figure.py figs/fig1.pdf figs/fig2.png --min-dpi 300
python check_figure.py figs/*.pdf --strict # 任意 FAIL 即 exit 2
"""
from __future__ import annotations
import argparse
import glob
import os
import sys
from typing import Any
JPEG_FORMATS = {"jpg", "jpeg"}
VECTOR_FORMATS = {"pdf", "svg", "eps"}
RASTER_OK_FORMATS = {"png", "tiff", "tif"}
# Severity 序号越高越严重
SEVERITY = {"INFO": 0, "WARN": 1, "FAIL": 2}
def _ext(path: str) -> str:
return os.path.splitext(path)[1].lower().lstrip(".")
def _check_raster(path: str, ext: str, min_dpi: int,
target_inches: tuple[float, float] | None) -> tuple[list, dict]:
"""位图(PNG/TIFF/JPEG)合规性检查。"""
issues: list[tuple[str, str]] = []
info: dict[str, Any] = {"category": "raster", "ext": ext}
if ext in JPEG_FORMATS:
issues.append(("FAIL",
"JPEG 不适合线条/文字类数据图(有损压缩)。"
"改用 PDF/SVG(矢量)或 PNG/TIFF(位图)。"))
try:
from PIL import Image
except ImportError:
issues.append(("INFO",
"Pillow 未安装,跳过像素/DPI 检查:"
"pip install Pillow 后可启用。"))
return issues, info
try:
img = Image.open(path)
info["size_px"] = img.size # (w, h)
dpi = img.info.get("dpi")
info["dpi"] = dpi
except Exception as e:
issues.append(("FAIL", f"无法读取图像:{e}"))
return issues, info
if dpi is None:
issues.append(("WARN",
"文件未嵌入 DPI 元数据。期刊往往按 DPI 折算最终尺寸,"
"请用 fig.savefig(dpi=300) 显式指定。"))
else:
dx = dpi[0] if isinstance(dpi, tuple) else dpi
# PIL roundtrips DPI as float and may give 299.9994 for a value saved
# at 300; round before compare to absorb that.
dx_rounded = round(float(dx))
if dx_rounded < min_dpi:
issues.append(("FAIL",
f"DPI = {dx_rounded} 低于要求的 {min_dpi}。"
"重新 savefig(dpi=...) 一次。"))
if target_inches is not None:
tw, th = target_inches
actual_w_in = info["size_px"][0] / float(dx)
actual_h_in = info["size_px"][1] / float(dx)
tol = 0.1 # 英寸容差
if abs(actual_w_in - tw) > tol or abs(actual_h_in - th) > tol:
issues.append((
"WARN",
f"实际尺寸 ≈ {actual_w_in:.2f}×{actual_h_in:.2f} in,"
f"目标 {tw}×{th} in。请在画图时直接设 figsize=({tw}, {th}),"
"不要在 Word/LaTeX 里二次缩放。"
))
return issues, info
def _check_pdf_fonts(path: str) -> list[tuple[str, str]]:
"""检查 PDF 的字体嵌入类型——多家期刊拒收 Type 3 (CFF outlines)。"""
issues: list[tuple[str, str]] = []
try:
from pypdf import PdfReader
except ImportError:
try:
from PyPDF2 import PdfReader # noqa: F401
except ImportError:
issues.append(("INFO",
"pypdf / PyPDF2 未安装,跳过字体嵌入类型检查。"
"pip install pypdf 后可启用。"))
return issues
try:
reader = PdfReader(path)
except Exception as e:
issues.append(("WARN", f"PDF 无法解析以检查字体:{e}"))
return issues
bad_fonts: list[str] = []
not_embedded: list[str] = []
for page in reader.pages:
try:
resources = page.get("/Resources")
if not resources:
continue
fonts = resources.get("/Font")
if not fonts:
continue
for fname, fobj in fonts.items():
font = fobj.get_object()
subtype = str(font.get("/Subtype", ""))
base = str(font.get("/BaseFont", "?"))
descriptor = font.get("/FontDescriptor")
if descriptor:
descriptor = descriptor.get_object()
embedded = any(k in descriptor for k in
("/FontFile", "/FontFile2", "/FontFile3"))
else:
embedded = False
if "Type3" in subtype:
bad_fonts.append(f"{base} ({subtype})")
elif not embedded and "Type1" not in subtype:
not_embedded.append(base)
except Exception:
continue
if bad_fonts:
issues.append((
"FAIL",
f"PDF 中含 Type 3 字体: {', '.join(set(bad_fonts))[:200]}. "
"Type 3 字体放大后会糊,多家期刊拒收。"
"在 matplotlib 中设 rcParams['pdf.fonttype'] = 42 重出图。"
))
if not_embedded:
issues.append((
"WARN",
f"PDF 中以下字体可能未嵌入: {', '.join(set(not_embedded))[:200]}. "
"导致他人电脑打开变成替代字体。"
))
return issues
def _check_svg(path: str) -> list[tuple[str, str]]:
"""SVG 简检:警告 base64 嵌入的位图(破坏矢量优势)。"""
issues: list[tuple[str, str]] = []
try:
with open(path, encoding="utf-8", errors="ignore") as f:
head = f.read(50000)
except Exception as e:
issues.append(("WARN", f"SVG 读失败: {e}"))
return issues
if "data:image/png;base64" in head or "data:image/jpeg;base64" in head:
issues.append(("WARN",
"SVG 中包含 base64 嵌入的位图——会丢失矢量优势。"
"检查是否在 plot 中误用了 imshow 或图像贴图。"))
return issues
def check_figure(path: str, min_dpi: int = 300,
target_inches: tuple[float, float] | None = None
) -> tuple[list[tuple[str, str]], dict]:
"""
审计一张图。返回 (issues, info)。
issues: [(severity, message), ...]; severity ∈ {INFO, WARN, FAIL}
info: 元数据字典(格式、像素、DPI 等)
"""
issues: list[tuple[str, str]] = []
info: dict[str, Any] = {"path": path}
if not os.path.exists(path):
return [("FAIL", f"文件不存在: {path}")], info
ext = _ext(path)
info["ext"] = ext
info["size_bytes"] = os.path.getsize(path)
if ext in VECTOR_FORMATS:
info["category"] = "vector"
if ext == "pdf":
issues.extend(_check_pdf_fonts(path))
elif ext == "svg":
issues.extend(_check_svg(path))
elif ext in RASTER_OK_FORMATS or ext in JPEG_FORMATS:
sub_issues, sub_info = _check_raster(path, ext, min_dpi, target_inches)
issues.extend(sub_issues)
info.update(sub_info)
else:
issues.append(("WARN", f"未识别的扩展名: .{ext}"))
return issues, info
def print_report(path: str, issues: list, info: dict) -> str:
"""以可读格式打印一张图的审计结果,返回 overall verdict 字符串。"""
print(f"\n--- {path} ---")
if "category" in info:
print(f" category: {info['category']} ext: {info['ext']} "
f"size: {info.get('size_bytes', '?')} B")
if info.get("size_px"):
print(f" pixels: {info['size_px'][0]}x{info['size_px'][1]} "
f"dpi: {info.get('dpi')}")
if not issues:
print(" [PASS] 无问题。")
return "PASS"
max_sev = max(SEVERITY[s] for s, _ in issues)
verdict = {2: "FAIL", 1: "WARN", 0: "INFO"}[max_sev]
for severity, msg in sorted(issues, key=lambda x: -SEVERITY[x[0]]):
print(f" [{severity}] {msg}")
print(f" >>> verdict: {verdict}")
return verdict
def _cli() -> int:
p = argparse.ArgumentParser(description="scipilot-figure-skill compliance checker")
p.add_argument("paths", nargs="+", help="图文件路径,可用 glob")
p.add_argument("--min-dpi", type=int, default=300)
p.add_argument("--width-in", type=float, help="目标宽度(英寸)")
p.add_argument("--height-in", type=float, help="目标高度(英寸)")
p.add_argument("--strict", action="store_true",
help="任意 FAIL 即 exit code 2")
args = p.parse_args()
target = None
if args.width_in and args.height_in:
target = (args.width_in, args.height_in)
expanded: list[str] = []
for pat in args.paths:
m = glob.glob(pat)
expanded.extend(m if m else [pat])
any_fail = False
for path in expanded:
issues, info = check_figure(path, min_dpi=args.min_dpi, target_inches=target)
verdict = print_report(path, issues, info)
if verdict == "FAIL":
any_fail = True
print()
if args.strict and any_fail:
print("[scipilot-figure-skill] strict mode: at least one FAIL — exit 2")
return 2
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 |