Gmt plot pipeline
Skill zhongpenggeo/gmt_plot_skill/.claude/skills/gmt_plot-pipeline
GMT 地学绘图完整流程技能。一站式 GMT 绘图解决方案,涵盖需求分析、数据下载、 GMT 代码编写与执行、图件视觉对比审阅、迭代修饰全流程。当你需要绘制地学图件时 应首先使用此技能。触发场景:用户要求绘制地形图、重力异常图、地震分布图、 剖面图、三维地形图或任何地学数据可视化图件;用户提到 GMT、Generic Mapping Tools、 地学绘图、地图绘制、地球物理数据可视化;用户想用 GMT 做科学制图。From its SKILL.md
npx -y skills add zhongpenggeo/gmt_plot_skill --skill gmt_plot-pipelineAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
4.9 KB, ~1.6k tokens by cl100k_base, as published. Nobody here has run it
GMT 地学绘图完整流程
你是一个 GMT 地学绘图全流程专家。你的任务是根据用户的绘图需求,通过以下标准流程完成从需求分析到最终图件输出的全过程。
全流程概览
用户需求 → [1.计划] → [2.下载数据] → [3.绘图] → [4.图件校验]
环境检查
首先检查 GMT 环境是否可用:
gmt --version
或者
conda activate gmt
gmt --version
如果 GMT 未安装,告知用户需要先安装 GMT:
- Ubuntu/Debian:
sudo apt install gmt gmt-dcw gmt-gshhg - 或参考 https://docs.gmt-china.org/latest/install/
阶段一:需求分析与计划制定
调用 gmt_plot:plan 技能制定绘图计划plan.md。
具体流程:
- 仔细分析用户的绘图需求
- 用websearch从网络上搜索相关的经验
- 如果需要更多信息,主动向用户提问澄清
- 制定完整的绘图计划(数据、模块、色标、排版)
- 计划保存为
plan.md到当前工作目录
参考文件:
- 读取
../gmt_plot-download/references/datasets.md了解所有可用数据集(GMT 远程数据 + 中文社区数据) - 读取
references/gmt-resources.md了解 GMT 模块和 CPT
阶段二:数据下载
调用 gmt_plot:download 技能获取所需数据。该技能内置了完整的数据集参考文件 references/datasets.md,
包含所有可用的 GMT 远程数据和中文社区数据及其下载方式,执行时直接查阅参考文件,无需上网搜索。
流程:
- 读取
plan.md中的数据需求 - 查阅下载技能的
references/datasets.md,匹配数据来源 - GMT 远程数据直接引用
@前缀,中文社区数据按参考文件中的 URL 下载 - 仅参考文件中未覆盖的数据才需要互联网搜索(需用户同意)
- 完成后输出数据清单
安全原则:
- 互联网下载前必须告知用户并获同意
- 本地目录搜索前必须告知用户并获同意
阶段三:绘图
调用 gmt_plot:plot 技能编写并执行 GMT 绘图代码。
流程:
- 读取
plan.md获取绘图方案 - 确认数据已就绪
- 确认 GMT 环境存在
conda env list | grep gmt - 编写 GMT 绘图脚本(优先 Bash GMT 命令格式)
- 对于不确定的模块参数,使用 Context7 或 WebSearch 查询文档
- 执行脚本,处理错误
- 确认输出文件生成
GMT 文档查询:
- 需要查询模块用法时,使用 Context7 查询
GenericMappingTools/gmt仓库 - 或使用 WebSearch 搜索 "GMT <模块名> docs generic-mapping-tools"
- 或使用 WebFetch 访问 https://docs.generic-mapping-tools.org/latest/
阶段四:图件布局校验
绘制完成后,调用 gmt_plot:verify 技能对生成的图件进行布局校验,确保排版质量。
流程:
- 确认 PNG/JPG 图件已生成
- 确保 OpenCV 已安装:
pip install opencv-python-headless numpy Pillow - 运行校验脚本:
python3 ../gmt_plot-verify/scripts/verify_plot.py <图件路径> --output verify_report.md --output-dir <输出目录> - 读取
verify_report.md,查看校验结果 - 如果存在 ❌ 不合格项(如色标与主图框间距不足、元素重叠等),应告知用户并建议调用
gmt_plot:polish进行修复 - 如果仅有 ⚠️ 需改进项,告知用户可选优化
- 如果全部通过,确认图件布局质量合格
校验项目包括:
- 色标与主图框间距(最小 2 像素或短边的 0.5%)
- 图例与主图间距
- 图例位置合理性(是否置于信息稀疏区域)
- 图例内部文字与标识重叠检测
- 元素越界检测
- 标注重叠检测
与 gmt_plot:compare 的区别:
compare使用视觉模型做整体审美和内容一致性评估verify使用 PIL 做精确的像素级布局检测- 两者互补,可在 pipeline 中先后使用
重要原则
- 每个阶段之间应该让用户确认:计划确认后才下载,下载确认后才绘图
- 保存中间产物:plan.md、gmt_plot.sh、*.ps 都应保存到工作目录
- 安全性优先:互联网下载和本地搜索必须获用户同意
- 文档查询:不确定 GMT 模块参数时,主动查询文档而不是猜测
- 错误处理:遇到错误时分析原因并修复,不要跳过
- 用户参与:关键决策点让用户参与,如计划修改、数据选择、色标偏好等
What ships with it: 1 file
2.5 KB alongside SKILL.md
references/
- gmt-resources.md2.5 KB