ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

figures4papers API参考清单:FigureStyle、apply_publication_style与绘图辅助函数参数全览

figures4papers API参考清单:FigureStyle、apply_publication_style与绘图辅助函数参数全览 figures4papers API参考清单FigureStyle、apply_publication_style与绘图辅助函数参数全览【免费下载链接】figures4papersMy Python scripts to make high-quality figures for publications in top AI conferences and journals.项目地址: https://gitcode.com/gh_mirrors/fi/figures4papersfigures4papers 是面向顶会论文Nature MI、ICML、NeurIPS、ECCV 等的高质量 Python 绘图脚本集。本文为 API 参考清单逐一拆解 scientific-figure-making/references/api.md 中定义的三大模块FigureStyle样式类、apply_publication_style样式应用函数以及make_*系列绘图辅助函数的完整参数帮助你快速复现出版级风格图表。一、快速上手获取仓库与技能入口git clone https://gitcode.com/gh_mirrors/fi/figures4papersAPI 约定集中在 scientific-figure-making/ 技能目录中文件用途SKILL.md技能总览与加载时机references/api.md函数签名、常量与校验规则本文依据references/tutorials.md柱状图/趋势图/热图端到端教程references/design-theory.md排版与配色设计原理references/common-patterns.md超宽画布、专属图例面板等布局模式 注意仓库本身不直接提供共享 Python 模块apply_publication_style、make_grouped_bar等函数需按 api.md 的约定自行实现或参照figure_*项目中的真实脚本改造。二、常量速查PALETTE 与 DEFAULT_COLORS PALETTE是出版级图表的语义色板颜色有明确的角色分工PALETTE { blue_main: #0F4D92, # 主蓝本方法/核心结果 blue_secondary: #3775BA, green_1: #DDF3DE, green_2: #AADCA9, green_3: #8BCF8B, # 绿色系改进项 red_1: #F6CFCB, red_2: #E9A6A1, red_strong: #B64342, # 红色系基线/对比 neutral: #CFCECE, highlight: #FFD700, teal: #42949E, violet: #9A4D8E, }DEFAULT_COLORS未显式传入colors参数时使用的有序列表[blue_main, green_3, red_strong, teal, violet, neutral]。三、FigureStyle 样式配置类冻结 dataclassfrozenTrue四个字段控制整体排版基调参数类型/默认值说明font_sizeint 16基础字号大尺寸柱状面板用24紧凑图用15–16axes_linewidthfloat 2.5坐标轴线宽大号柱状图用3紧凑图用2use_texbool False仅在已安装 LaTeX 且需要数学标签时设为Truefont_familytuple (DejaVu Sans, Helvetica, Arial, sans-serif)无衬线字体回退栈四、apply_publication_style 一键应用函数apply_publication_style(styleNone)配置 matplotlib 的rcParams关闭 top/right 边框线、无框图例、字体族/字号、矢量导出选项等。每个脚本只需在创建图形前调用一次apply_publication_style(FigureStyle(font_size24, axes_linewidth3))五、布局与导出create_subplots 与 finalize_figurecreate_subplotsfig, axes create_subplots(nrows1, ncols1, figsizeNone, **kwargs)返回(fig, axes)axes为一维展平的 Axes 数组figsize以英寸为单位如figsize(12, 8)多指标对比推荐超宽画布如figsize(45, 12)详见 common-patterns.md。finalize_figuresaved finalize_figure(fig, out_path, formatsNone, dpi300, closeTrue, pad0.05, **kwargs)参数说明out_path输出基路径不含扩展名自动创建父目录formats多格式列表如[png, pdf]为None时取out_path扩展名或默认 pdf/svg/epsdpi默认 300密集柱状面板可提到 600close保存后是否关闭图形批量脚本建议Truepad边缘留白如pad0.06支持格式pdf、svg、eps、png、jpg、jpeg、tif、tiff返回已保存Path列表。六、绘图辅助函数参数全览 ✏️make_grouped_bar分组柱状图bars make_grouped_bar(ax, categories, series, labels, ylabelValue, colorsNone, annotateFalse)参数说明categoriesx 轴类别列表长度须等于series每行的列数series数组列表每组一个长度同categorieslabels图例标签数量同seriesannotate是否直接在柱顶标注数值返回BarContainer供annotate_bars复用annotate_bars柱顶数值标注annotate_bars(ax, bars, fmt{:.2f}, fontsize10, padding3)在BarContainer每根柱子上方添加文本fmt控制数值格式。make_trend多曲线趋势图make_trend(ax, x, y_series, labels, colorsNone, ylabelNone, xlabelNone, show_shadowTrue)y_series一维数组列表每条与x等长show_shadow是否绘制不确定性阴影带fill_between。make_heatmap热图make_heatmap(ax, matrix, x_labelsNone, y_labelsNone, cmapmagma, cbar_labelNone, annotateFalse)渲染二维矩阵可选色条标签与单元格数值标注默认cmapmagma。make_scatter散点图make_scatter(ax, x, y, labelNone, colorNone, size50, alpha0.7)单序列散点x、y必须等长。make_sphere_illustration3D 球体示意make_sphere_illustration(ax, light_dir(-0.5, 0.5, 0.8), resolution128, alpha0.6)用带阴影的 2D 圆盘模拟 3D 球体适合概念示意图light_dir控制光源方向resolution控制渲染精度。七、校验规则与工程约定 ✅参数校验实现时须遵循所有数值序列统一转为 numpy 数组强制一维/二维与长度检查make_grouped_barlen(categories)必须等于series列数make_trend每条序列必须与x等长finalize_figure仅支持 pdf/svg/eps/png/jpg/jpeg/tif/tiff。工程约定输出统一存放到项目的figures/目录基名保持稳定批量/无头运行需在import matplotlib.pyplot前设置非交互后端如matplotlib.use(Agg);若图型、面板数、配色角色或数据布局存在歧义应先与使用者确认再定稿。八、真实脚本参照figure_* 演示目录以下项目目录是上述 API 的规范实现可直接阅读改造清单见 references/demos.md项目适用图型参考脚本figure_ImmunoStruct定量对比柱状图plot_bars.pyfigure_CellSpliceNet多面板柱状对比plot_comparison.pyfigure_VIGIL雷达图、折线消融plot_ablation.pyfigure_ophthal_review趋势图plot_trend.pyfigure_RNAGenScape热图plot_comparison.pyfigure_Dispersion3D 球体示意plot_illustration.py以 figure_CellSpliceNet/plot_comparison.py 为例脚本头部即体现了本文的样式约定Helvetica 字体、字号 24、关闭 top/right 边框、线宽 3。九、延伸阅读设计原理与rcParams预设references/design-theory.md分步教程柱状/趋势/热图references/tutorials.mdAI 编码代理集成方式路径引用或符号链接安装技能见 README.md 的 LLM skill integration 一节掌握FigureStyleapply_publication_stylemake_*助手三件套你就能在任何 matplotlib 项目中稳定产出与 figures4papers 一致的顶会出版级图表 【免费下载链接】figures4papersMy Python scripts to make high-quality figures for publications in top AI conferences and journals.项目地址: https://gitcode.com/gh_mirrors/fi/figures4papers创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表