PyGMT 是面向地理制图与地理空间网格处理的 Python 工具，底层依赖 GMT（Generic Mapping Tools）。其目标是产出一张投影方式、坐标单位与数据覆盖范围都明确可查的地图。
用途 PyGMT 用于制作地理地图并处理地理空间栅格网格，涵盖投影选择、区域范围设定、网格配准，以及矢量与栅格数据的导出。
主要能力
- 地图绘制：通过 Figure 对象设置区域（region）与投影（projection），绘制底图、点位等要素。
- 网格处理：对栅格网格进行网格化与显示，需在 grdimage 之前检查间距与配准方式。
- 导出：可将图形保存为输出文件（如 PDF），导出图形时建议配合 Ghostscript。
- 远程数据集：如 Earth relief 等远程数据集需要明确分辨率、缓存、许可与下载体积。
使用方式 资料给出一个离线合成地图示例，使用三个示意位置点，不依赖远程地形或海岸线数据集：
example: synthetic-map
import pygmt
figure = pygmt.Figure() figure.basemap(region=[5, 10, 44, 48], projection="M10c", frame=["af", "+tSynthetic locations"]) figure.plot(x=[6, 7.5, 9], y=[45, 46, 47], style="c0.18c", fill="navy", pen="0.4p,black") figure.savefig(output_pdf)
该示例要求 output_pdf 指定一个新的输出文件名。示例中的三个位置为示意，并非实测数据。
环境要求 PyGMT 0.19 需要 Python 3.12+ 与 GMT 6.5+。仅安装 Python 包不会安装 GMT 共享库，应使用文档所述的 conda-forge 隔离环境，并在导出图形时使用 Ghostscript。需分别记录 PyGMT 与 GMT 的版本。
输入与地图设计 需先确定地理坐标与投影坐标、水平 CRS、经度约定与垂直基准；有意识地选择区域 [west, east, south, north] 与投影；决定采用像素配准还是网格线配准；在网格化或图像显示前核对坐标顺序、间距与 NaN 掩膜。不要将投影后的米制坐标误当作经纬度。
验证与交付 重新打开导出的文件，检查边界、标注、方向、缺失数据区域与色标；将控制点坐标与输入比对；涉及网格操作时，通过 GMT 采样已知网格节点。交付地图时应一并提供源数据引用、脚本、CRS/投影与导出设置。
适用场景 适用于需要明确投影与坐标体系的地理制图、地理空间栅格网格处理与矢量/栅格导出任务。
限制 资料未提供收费、价格、平台支持范围、性能指标或具体使用步骤之外的更多细节；远程数据集的分辨率、缓存、许可与下载体积需按文档另行确认。